Betalningsmetoder
På denna sida
Hantera dina betalningsmetoder
Management API låter dig visa registrerade kort och ställa in standardbetalningsmetod för automatiska debiteringar. Att hantera detta är avgörande för att undvika serviceavbrott orsakade av misslyckade betalningar.
Visa betalningsmetoder
Att hantera kort via API:t har ett praktiskt mål, men det är kritiskt: upptäck ett kort som håller på att gå ut innan en debitering misslyckas. En misslyckad faktura är inte bara en isolerad ekonomisk händelse – den leder till avstängning av tjänsten, vilket i praktiken är ett produktionsavbrott som har sitt ursprung i redovisningen.
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/payment-method" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Svaret innehåller information för varje kort: typ (Visa, Mastercard, etc.), de fyra sista siffrorna, utgångsdatum och status (aktiv, standard).
Ställ in standardbetalningsmetod
För att byta kortet som används för automatiska debiteringar:
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 är identifieraren som returneras av visningsendpunkten. Ändringen träder i kraft för kommande debiteringar – inte för de som redan pågår. Om en fakturas status ändras till FAILED åtgärdar ett byte av standardkortet inte automatiskt fakturan: åtgärda betalningsmetoden först och kontrollera sedan status för den berörda fakturan.
Accepterade kort
xAI accepterar en bred uppsättning betalkort för API:t:
- Visa
- Mastercard
- American Express (AMEX)
- Discover
- JCB
- UnionPay
Viktig begränsning: Indiska kort
Betalkort utfärdade i Indien accepteras inte för användning av xAI API. Denna begränsning gäller endast API:t – betalningar för konsumenttjänsten Grok (via grok.com eller mobilappar) påverkas inte av denna begränsning.
Om du är baserad i Indien och vill använda API:t måste du använda ett kort utfärdat i ett annat land eller utforska andra betalningsalternativ.
Bästa praxis för betalningshantering
Ha ett reservkort
Registrera minst två betalningsmetoder, helst på två olika konton. Scenariot detta täcker är vanligt och kostsamt: företagskortet byts ut, ingen tänker på att inkludera API:t i listan över prenumerationer som ska uppdateras, och tjänsten stoppas tre veckor senare. En misslyckad betalning (status FAILED) kan leda till tillfällig avstängning av dina API-nycklar.
Övervaka utgångsdatum
Kontrollera regelbundet utgångsdatum för dina registrerade kort. Uppdatera kort innan de går ut för att undvika avbrott.
Betalningsvarningar
Kombinera visning av fakturor (GET /invoices) med ett varningsskript:
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.)
Integrera i din infrastruktur
Automatiserad verifiering
Integrera periodisk verifiering av betalningsstatus i din övervakning:
# 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')
"
Viktiga punkter
GET /v1/billing/teams/{teamId}/payment-methodlistar registrerade kortPOST /v1/billing/teams/{teamId}/payment-method/defaultställer in standardkortet- Kort från Visa, Mastercard, AMEX, Discover, JCB och UnionPay accepteras
- Indiska kort accepteras inte för API:t (men fungerar för grok.com)
- Ha alltid minst två kort registrerade för att undvika avbrott
- Övervaka statusen FAILED i dina fakturor för att upptäcka betalningsproblem