Spôsoby platby
Na tejto strane
Správa spôsobov platby
Management API ti umožňuje zobraziť registrované karty a nastaviť predvolený spôsob platby pre automatické účtovanie. Správa tohto nastavenia je nevyhnutná na predchádzanie prerušeniam služby spôsobeným neúspešnými platbami.
Zobrazenie spôsobov platby
Správa kariet prostredníctvom API má jeden praktický, no kritický cieľ: odhaliť kartu, ktorej platnosť čoskoro vyprší, skôr, než dôjde k zlyhaniu platby. Nezaplatená faktúra nie je len izolovanou finančnou udalosťou – vedie k pozastaveniu služby, čo je v podstate výpadok produkcie spôsobený účtovníctvom.
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/payment-method" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Odozva obsahuje informácie o každej karte: typ (Visa, Mastercard atď.), posledné 4 číslice, dátum exspirácie a stav (aktívna, predvolená).
Nastavenie predvoleného spôsobu platby
Ak chceš zmeniť kartu používanú na automatické účtovanie:
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 je identifikátor vrátený koncovým bodom pre zobrazenie. Zmena sa prejaví pri nadchádzajúcich platbách, nie pri tých, ktoré už prebiehajú. Ak sa stav faktúry zmení na FAILED (zlyhané), zmena predvolenej karty ju automaticky nepokusí znova zaplatiť: najprv oprav spôsob platby a následne skontroluj stav dotknutej faktúry.
Akceptované karty
xAI akceptuje širokú škálu platobných kariet pre API:
- Visa
- Mastercard
- American Express (AMEX)
- Discover
- JCB
- UnionPay
Dôležité obmedzenie: Indické karty
Platobné karty vydané v Indii nie sú akceptované na používanie API xAI. Toto obmedzenie sa vzťahuje výlučne na API – platby za spotrebiteľskú službu Grok (cez grok.com alebo mobilné aplikácie) týmto obmedzením nie sú dotknuté.
Ak sídliš v Indii a chceš používať API, musíš použiť kartu vydanú v inej krajine alebo preskúmať iné možnosti platby.
Osvedčené postupy pri správe platieb
Mať záložnú kartu
Zaregistruj si aspoň dva spôsoby platby, ideálne na dvoch rôznych účtoch. Tento postup pokrýva bežný a nákladný scenár: firemná karta sa vymení, nikto nezahrnie API do zoznamu predplatných na aktualizáciu a o tri týždne sa služba zastaví. Neúspešná platba (stav FAILED) môže viesť k dočasnému pozastaveniu tvojich API kľúčov.
Monitorovanie dátumov exspirácie
Pravidelne kontroluj dátumy exspirácie registrovaných kariet. Aktualizuj karty skôr, než im vyprší platnosť, aby si predišiel akémukoľvek prerušeniu.
Upozornenia na platby
Skombinuj zobrazovanie faktúr (GET /invoices) so skriptom na upozornenia:
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.)
Integrácia do tvojej infraštruktúry
Automatizovaná verifikácia
Zaraď pravidelnú verifikáciu stavu platieb do svojho monitorovania:
# Mesačný overovací skript
#!/bin/bash
RESPONSE=$(curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/payment-method" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY")
# Skontroluj, či je predvolená karta aktívna
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')
"
Kľúčové poznatky
GET /v1/billing/teams/{teamId}/payment-methodvypíše zoznam registrovaných karietPOST /v1/billing/teams/{teamId}/payment-method/defaultnastaví predvolenú kartu- Akceptované sú karty Visa, Mastercard, AMEX, Discover, JCB a UnionPay
- Indické karty nie sú akceptované pre API (fungujú však pre grok.com)
- Vždy maj zaregistrované aspoň dve karty, aby si predišiel prerušeniam
- Monitoruj stavy FAILED na svojich faktúrach, aby si včas odhalil problémy s platbami