Salt la conținutul principal
Română— Alege o limbă
Meniu

Metode de plată

Lecția 6 din 14 Actualizată 29 iulie 2026 Dezvoltator
Pe această pagină
  1. Gestionarea metodelor de plată
  2. Vizualizarea metodelor de plată
  3. Setarea metodei de plată implicite
  4. Carduri acceptate
  5. Cele mai bune practici pentru gestionarea plăților
  6. Integrarea în infrastructura dumneavoastră
  7. Puncte cheie

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-method listează cardurile înregistrate
  • POST /v1/billing/teams/{teamId}/payment-method/default setează 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ă