Metode de plată
Pe această pagină
Gestionarea metodelor de plată
API-ul de Management vă permite să vizualizați cardurile înregistrate și să stabiliți metoda de plată implicită pentru taxările automate. Gestionarea acestui aspect este esențială pentru a evita întreruperile serviciului cauzate de plățile eșuate.
Vizualizarea metodelor de plată
Gestionarea cardurilor prin API are un obiectiv practic, dar critic: detectarea unui card care urmează să expire înainte ca o taxare să eșueze. O factură neplătită nu este doar un incident financiar izolat; ea duce la suspendarea serviciului, ceea ce echivalează, în esență, cu o pană de producție originată în departamentul contabil.
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/payment-method" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Răspunsul conține informații pentru fiecare card: tipul (Visa, Mastercard etc.), ultimele 4 cifre, data expirării și statutul (activ, implicit).
Setarea metodei de plată implicite
Pentru a schimba cardul utilizat pentru taxările automate:
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"
}'
paymentMethodId este identificatorul returnat de endpoint-ul de vizualizare. Modificarea intră în vigoare pentru taxările viitoare, nu și pentru cele deja în curs de desfășurare. Dacă statutul unei facturi se schimbă în FAILED (eșuat), schimbarea cardului implicit nu reîncearcă automat plata: trebuie mai întâi să corectați metoda de plată, apoi să verificați statutul facturii afectate.
Carduri acceptate
xAI acceptă o gamă largă de carduri de plată pentru API:
- Visa
- Mastercard
- American Express (AMEX)
- Discover
- JCB
- UnionPay
Restricție importantă: Carduri din India
Cardurile de plată emise în India nu sunt acceptate pentru utilizarea API-ului xAI. Această restricție se aplică doar API-ului; plățile pentru serviciul consumer Grok (prin grok.com sau aplicațiile mobile) nu sunt afectate de această limitare.
Dacă aveți sediul în India și doriți să utilizați API-ul, trebuie să folosiți un card emis într-o altă țară sau să explorați alte opțiuni de plată.
Cele mai bune practici pentru gestionarea plăților
Păstrați un card de rezervă
Înregistrați cel puțin două metode de plată, de preferință pe două conturi diferite. Scenariul vizat este comun și costisitor: cardul companiei este înlocuit, nimeni nu se gândește să includă API-ul în lista de abonamente de actualizat, iar serviciul se oprește trei săptămâni mai târziu. O plată eșuată (statut FAILED) poate duce la suspendarea temporară a cheilor dumneavoastră API.
Monitorizați expirările
Verificați regulat datele de expirare ale cardurilor înregistrate. Actualizați cardurile înainte de expirare pentru a evita orice întrerupere.
Alertele de plată
Combinați vizualizarea facturilor (GET /invoices) cu un script de alertă:
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!")
# Send a notification (email, Slack, etc.)
Integrarea în infrastructura dumneavoastră
Verificare automată
Integrați verificarea periodică a statutului plăților în sistemul dumneavoastră de monitorizare:
# Monthly verification script
#!/bin/bash
RESPONSE=$(curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/payment-method" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY")
# Check if a default card is active
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')
"
Puncte cheie
GET /v1/billing/teams/{teamId}/payment-methodlistează cardurile înregistratePOST /v1/billing/teams/{teamId}/payment-method/defaultsetează cardul implicit- Sunt acceptate cardurile Visa, Mastercard, AMEX, Discover, JCB și UnionPay
- Cardurile din India nu sunt acceptate pentru API (dar funcționează pentru grok.com)
- Păstrați întotdeauna cel puțin două carduri înregistrate pentru a evita întreruperile
- Monitorizați statusurile FAILED din facturile dumneavoastră pentru a detecta problemele de plată