Betaalmethoden
Op deze pagina
Uw betaalmethoden beheren
Met de Management API kunt u geregistreerde kaarten bekijken en de standaardbetaalmethode voor automatische afschrijvingen instellen. Dit beheer is essentieel om onderbrekingen van de dienstverlening als gevolg van mislukte betalingen te voorkomen.
Betaalmethoden bekijken
Het beheren van kaarten via de API heeft één praktisch doel, maar dit is cruciaal: een kaart detecteren die op het punt staat te verlopen voordat een afschrijving mislukt. Een mislukte factuur is niet zomaar een geïsoleerd financieel incident; het leidt tot opschorting van de dienst, wat in feite neerkomt op een productiestoring die zijn oorsprong vindt in de administratie.
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/payment-method" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Het antwoord bevat informatie voor elke kaart: het type (Visa, Mastercard, enz.), de laatste 4 cijfers, de vervaldatum en de status (actief, standaard).
De standaardbetaalmethode instellen
Om de kaart te wijzigen die wordt gebruikt voor automatische afschrijvingen:
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"
}'
De paymentMethodId is de identifier die wordt teruggegeven door het view-endpoint. De wijziging gaat in voor toekomstige afschrijvingen, niet voor die welke al gaande zijn. Als de status van een factuur verandert in FAILED, leidt het wijzigen van de standaardkaart niet tot een automatische nieuwe poging: los het probleem met de betaalmethode op en controleer vervolgens de status van de betreffende factuur.
Geaccepteerde kaarten
xAI accepteert een breed scala aan betaalkaarten voor de API:
- Visa
- Mastercard
- American Express (AMEX)
- Discover
- JCB
- UnionPay
Belangrijke beperking: Indiase kaarten
Betaalkaarten die in India zijn uitgegeven, worden niet geaccepteerd voor gebruik van de xAI API. Deze beperking geldt alleen voor de API; betalingen voor de consumentendienst Grok (via grok.com of mobiele apps) worden door deze beperking niet beïnvloed.
Als u in India gevestigd bent en de API wilt gebruiken, moet u een kaart gebruiken die in een ander land is uitgegeven of andere betalingsopties onderzoeken.
Best practices voor betalingsbeheer
Houd een reservekaart aan
Registreer minimaal twee betaalmethoden, bij voorkeur op twee verschillende accounts. Het scenario dat hiermee wordt gedekt, komt vaak voor en is kostbaar: de bedrijfskaart wordt vervangen, niemand denkt eraan om de API op te nemen in de lijst met abonnementen die moeten worden bijgewerkt, en de dienst stopt drie weken later. Een mislukte betaling (status FAILED) kan leiden tot tijdelijke opschorting van uw API-sleutels.
Controleer vervaldatums
Controleer regelmatig de vervaldatums van uw geregistreerde kaarten. Werk kaarten bij voordat ze verlopen om onderbrekingen te voorkomen.
Betalingswaarschuwingen
Combineer het bekijken van facturen (GET /invoices) met een waarschuwingsscript:
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.)
Integratie in uw infrastructuur
Geautomatiseerde verificatie
Integreer periodieke verificatie van de betalingsstatus in uw monitoring:
# 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')
"
Belangrijkste punten
GET /v1/billing/teams/{teamId}/payment-methodgeeft een overzicht van geregistreerde kaartenPOST /v1/billing/teams/{teamId}/payment-method/defaultstelt de standaardkaart in- Kaarten van Visa, Mastercard, AMEX, Discover, JCB en UnionPay worden geaccepteerd
- Indiase kaarten worden niet geaccepteerd voor de API (maar werken wel voor grok.com)
- Houd altijd minimaal twee kaarten geregistreerd om onderbrekingen te voorkomen
- Controleer op statussen FAILED in uw facturen om betalingsproblemen tijdig op te sporen