Betalingsmetoder
På denne side
Administrer dine betalingsmetoder
Management API’en giver dig mulighed for at se registrerede kort og indstille den standardbetalingsmetode, der bruges til automatiske opkrævninger. Det er afgørende at administrere dette for at undgå serviceafbrydelser forårsaget af mislykkede betalinger.
Se betalingsmetoder
At administrere kort via API’en har ét praktisk mål, men det er kritisk: at opdage et kort, der er ved at udløbe, før en opkrævning mislykkes. En mislykket faktura er ikke blot en isoleret finansiel hændelse – den fører til suspension af servicen, hvilket i bund og grund er en produktionsnedetid, der har sin oprindelse i regnskabet.
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/payment-method" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Svaret indeholder oplysninger for hvert kort: type (Visa, Mastercard osv.), de sidste 4 cifre, udløbsdatoen og status (aktiv, standard).
Indstil standardbetalingsmetoden
For at ændre det kort, der bruges til automatiske opkrævninger:
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 er identifikatoren, der returneres af visnings-endpointet. Ændringen træder i kraft for kommende opkrævninger – ikke dem, der allerede er i gang. Hvis status på en faktura ændres til FAILED, vil en ændring af standardkortet ikke automatisk genforsøge betalingen: du skal rette betalingsmetoden og derefter kontrollere status på den berørte faktura.
Accepterede kort
xAI accepterer en bred vifte af betalingskort til API’en:
- Visa
- Mastercard
- American Express (AMEX)
- Discover
- JCB
- UnionPay
Vigtig begrænsning: Indiske kort
Betalingskort udstedt i Indien accepteres ikke til brug af xAI API’en. Denne begrænsning gælder kun for API’en – betalinger for Grok-tjenesten til forbrugere (via grok.com eller mobilapps) påvirkes ikke af denne begrænsning.
Hvis du er baseret i Indien og ønsker at bruge API’en, skal du bruge et kort udstedt i et andet land eller undersøge andre betalingsmuligheder.
Bedste praksis for betalingsadministration
Hav et reservekort
Registrer mindst to betalingsmetoder, helst på to forskellige konti. Scenariet, dette dækker, er almindeligt og kostbart: firmakortet bliver udskiftet, ingen tænker på at inkludere API’en i listen over abonnementer, der skal opdateres, og servicen stopper tre uger senere. En mislykket betaling (status FAILED) kan føre til midlertidig suspension af dine API-nøgler.
Overvåg udløbsdatoer
Kontrollér regelmæssigt udløbsdatoerne på dine registrerede kort. Opdater kort, før de udløber, for at undgå afbrydelser.
Betalingsalarmer
Kombinér visning af fakturaer (GET /invoices) med et alarmscript:
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 en notifikation (e-mail, Slack osv.)
Integrer i din infrastruktur
Automatiseret verifikation
Integrer periodisk verifikation af betalingsstatus i din overvågning:
# Månedligt verifikationsscript
#!/bin/bash
RESPONSE=$(curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/payment-method" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY")
# Tjek om et standardkort er aktivt
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')
"
Vigtige pointer
GET /v1/billing/teams/{teamId}/payment-methodlister registrerede kortPOST /v1/billing/teams/{teamId}/payment-method/defaultindstiller standardkortet- Visa, Mastercard, AMEX, Discover, JCB og UnionPay-kort accepteres
- Indiske kort accepteres ikke til API’en (men fungerer til grok.com)
- Hav altid mindst to kort registreret for at undgå afbrydelser
- Overvåg FAILED-statusser på dine fakturaer for at opdage betalingsproblemer