Fizetési módok
Ezen az oldalon
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-methodkilistázza a regisztrált kártyákat - A
POST /v1/billing/teams/{teamId}/payment-method/defaultbeá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