Platební metody
Na této stránce
Správa platebních metod
Management API ti umožňuje zobrazit registrované karty a nastavit výchozí platební metodu pro automatické platby. Správa tohoto nastavení je zásadní pro předcházení přerušení služby způsobeným neúspěšnými platbami.
Zobrazení platebních metod
Správa karet prostřednictvím API má jeden praktický, ale kritický cíl: odhalit kartu blížící se konci platnosti dříve, než dojde k selhání platby. Neuhrazená faktura není jen izolovanou finanční událostí – vede k pozastavení služby, což je v podstatě výpadek produkce vzniklý v účetnictví.
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/payment-method" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Odpověď obsahuje informace o každé kartě: typ (Visa, Mastercard atd.), poslední 4 číslice, datum expirace a stav (aktivní, výchozí).
Nastavení výchozí platební metody
Pro změnu karty používané pro automatické platby:
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ácený koncovým bodem pro zobrazení. Změna se projeví u nadcházejících plateb, nikoliv u těch, které již probíhají. Pokud se stav faktury změní na FAILED, přepnutí výchozí karty ji automaticky nezopakuje: nejprve oprav platební metodu a poté zkontroluj stav dotčené faktury.
Akceptované karty
xAI přijímá pro API širokou škálu platebních karet:
- Visa
- Mastercard
- American Express (AMEX)
- Discover
- JCB
- UnionPay
Důležité omezení: Indické karty
Platební karty vydané v Indii nejsou akceptovány pro používání xAI API. Toto omezení se týká pouze API – platby za spotřebitelskou službu Grok (prostřednictvím grok.com nebo mobilních aplikací) tímto omezením nejsou dotčeny.
Pokud sídlíš v Indii a chceš používat API, musíš použít kartu vydanou v jiné zemi nebo prozkoumat jiné platební možnosti.
Osvědčené postupy pro správu plateb
Měj záložní kartu
Zaregistruj alespoň dvě platební metody, ideálně na dvou různých účtech. Tento scénář je běžný a nákladný: firemní karta je vyměněna, nikdo nepomyslí na zahrnutí API do seznamu předplatných k aktualizaci a služba se o tři týdny později zastaví. Neúspěšná platba (stav FAILED) může vést k dočasnému pozastavení tvých API klíčů.
Sleduj data expirace
Pravidelně kontroluj data expirace svých registrovaných karet. Aktualizuj karty před jejich vypršením, aby nedošlo k žádnému přerušení.
Upozornění na platby
Zkombinuj zobrazování faktur (GET /invoices) se skriptem pro upozornění:
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!")
# Odeslat oznámení (e-mail, Slack atd.)
Integrace do tvé infrastruktury
Automatizovaná verifikace
Integruj pravidelnou verifikaci stavu plateb do svého monitoringu:
# Měsíční ověřovací skript
#!/bin/bash
RESPONSE=$(curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/payment-method" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY")
# Zkontroluj, zda je výchozí karta aktivní
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')
"
Klíčové poznatky
GET /v1/billing/teams/{teamId}/payment-methodvypíše registrované kartyPOST /v1/billing/teams/{teamId}/payment-method/defaultnastaví výchozí kartu- Akceptovány jsou karty Visa, Mastercard, AMEX, Discover, JCB a UnionPay
- Indické karty nejsou akceptovány pro API (fungují však pro grok.com)
- Vždy měj zaregistrované alespoň dvě karty, abys předešel přerušením
- Sleduj stavy FAILED ve svých fakturách, abys odhalil problémy s platbami