Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Betaalmethoden

Les 6 van 14 Bijgewerkt op 29 juli 2026 Ontwikkelaar
Op deze pagina
  1. Uw betaalmethoden beheren
  2. Betaalmethoden bekijken
  3. De standaardbetaalmethode instellen
  4. Geaccepteerde kaarten
  5. Best practices voor betalingsbeheer
  6. Integratie in uw infrastructuur
  7. Belangrijkste punten

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-method geeft een overzicht van geregistreerde kaarten
  • POST /v1/billing/teams/{teamId}/payment-method/default stelt 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