Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Fizetési módok

6. lecke 14 közül Frissítve 2026. július 29. Fejlesztő
Ezen az oldalon
  1. Fizetési módok kezelése
  2. Fizetési módok megtekintése
  3. Az alapértelmezett fizetési mód beállítása
  4. Elfogadott kártyák
  5. A fizetéskezelés legjobb gyakorlatai
  6. Integráció az infrastruktúrádba
  7. Főbb megállapítások

Fizetési módok kezelése

A Management API lehetővé teszi a regisztrált bankkártyák megtekintését és az automatikus terhelésekhez használt alapértelmezett fizetési mód beállítását. Ennek kezelése elengedhetetlen a sikertelen fizetésekből eredő szolgáltatásmegszakítások elkerülése érdekében.

Fizetési módok megtekintése

A kártyák API-n keresztüli kezelésének egyetlen gyakorlati, de kritikus célja van: még mielőtt egy terhelés meghiúsulna, észleld a lejáró kártyát. Egy sikertelen számla nem csupán elszigetelt pénzügyi incidens – szolgáltatásfelfüggesztéshez vezet, ami lényegében egy számviteli eredetű éles környezetbeli kiesést jelent.

curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/payment-method" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

A válasz minden kártyára vonatkozóan tartalmazza az alábbi információkat: típus (Visa, Mastercard stb.), az utolsó 4 számjegy, a lejárati dátum és az állapot (aktív, alapértelmezett).

Az alapértelmezett fizetési mód beállítása

Az automatikus terhelésekhez használt kártya módosításához:

curl -X POST "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/payment-method/default" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "paymentMethodId": "pm_abc123"
  }'

A paymentMethodId az azonosító, amelyet a megtekintési végpont ad vissza. A változtatás a jövőbeli terhelésekre lép életbe – a már folyamatban lévőkre nem. Ha egy számla állapota FAILED-re (sikertelen) változik, az alapértelmezett kártya cseréje nem indítja el automatikusan az újbóli próbálkozást: először javítsd ki a fizetési módot, majd ellenőrizd az érintett számla állapotát.

Elfogadott kártyák

Az xAI széles körű bankkártyát fogad el az API használatához:

  • Visa
  • Mastercard
  • American Express (AMEX)
  • Discover
  • JCB
  • UnionPay

Fontos korlátozás: indiai kártyák

Az Indiában kibocsátott bankkártyák nem elfogadottak az xAI API használatához. Ez a korlátozás kizárólag az API-ra vonatkozik – a fogyasztói Grok szolgáltatásért (a grok.com-on vagy mobilalkalmazásokon keresztül) történő fizetéseket ez a korlátozás nem érinti.

Ha Indiában élsz, és használni szeretnéd az API-t, egy másik országban kibocsátott kártyát kell használnod, vagy más fizetési lehetőségeket kell keresned.

A fizetéskezelés legjobb gyakorlatai

Tartalék kártya használata

Regisztrálj legalább két fizetési módot, lehetőleg két különböző fiókon. Ez a forgatókönyv gyakori és költséges: a vállalati kártyát kicserélik, senki nem gondol arra, hogy frissítse az API-t az előfizetések listáján, és a szolgáltatás három héttel később leáll. Egy sikertelen fizetés (FAILED állapot) az API-kulcsaid ideiglenes felfüggesztéséhez vezethet.

Lejáratok figyelése

Rendszeresen ellenőrizd a regisztrált kártyáid lejárati dátumát. Frissítsd a kártyákat lejáratuk előtt, hogy elkerüld a megszakításokat.

Fizetési riasztások

Kombináld a számlák megtekintését (GET /invoices) egy riasztó szkripttel:

import requests

MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."

response = requests.get(
    f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/invoices?billingCycle.year=2026&billingCycle.month=4",
    headers={"Authorization": f"Bearer {MGMT_KEY}"}
)

invoices = response.json()
for invoice in invoices.get("invoices", []):
    if invoice.get("status") == "FAILED":
        print(f"ALERT: invoice {invoice['id']} failed!")
        # Küldj értesítést (e-mail, Slack stb.)

Integráció az infrastruktúrádba

Automatizált ellenőrzés

Építsd be a periodikus fizetési állapot-ellenőrzést a monitoring rendszeredbe:

# Havi ellenőrző szkript
#!/bin/bash
RESPONSE=$(curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/payment-method" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY")

# Ellenőrizd, van-e aktív alapértelmezett kártya
echo "$RESPONSE" | python3 -c "
import sys, json
data = json.load(sys.stdin)
methods = data.get('paymentMethods', [])
if not methods:
    print('ALERT: no payment method registered')
    sys.exit(1)
default = [m for m in methods if m.get('isDefault')]
if not default:
    print('ALERT: no default payment method')
    sys.exit(1)
print('OK: default payment method active')
"

Főbb megállapítások

  • A GET /v1/billing/teams/{teamId}/payment-method kilistázza a regisztrált kártyákat
  • A POST /v1/billing/teams/{teamId}/payment-method/default beállítja az alapértelmezett kártyát
  • A Visa, Mastercard, AMEX, Discover, JCB és UnionPay kártyák elfogadottak
  • Az indiai kártyák nem elfogadottak az API-hoz (de működnek a grok.com-on)
  • Mindig tarts regisztrálva legalább két kártyát a megszakítások elkerülése érdekében
  • Figyeld a FAILED állapotokat a számláidon a fizetési problémák észleléséhez