Zum Hauptinhalt springen
Deutsch— Sprache auswählen
Menü

Zahlungsmethoden

Lektion 6 von 14 Aktualisiert am 29. Juli 2026 Entwickler
Auf dieser Seite
  1. Verwaltung Ihrer Zahlungsmethoden
  2. Zahlungsmethoden anzeigen
  3. Festlegen der Standardzahlungsmethode
  4. Akzeptierte Karten
  5. Best Practices für die Zahlungsverwaltung
  6. In Ihre Infrastruktur integrieren
  7. Kernaussagen

Verwaltung Ihrer Zahlungsmethoden

Die Management API ermöglicht es Ihnen, registrierte Karten anzuzeigen und die Zahlungsmethode für automatische Belastungen als Standard festzulegen. Diese Verwaltung ist unerlässlich, um Service-Unterbrechungen durch fehlgeschlagene Zahlungen zu vermeiden.

Zahlungsmethoden anzeigen

Die Verwaltung von Karten über die API verfolgt ein einziges praktisches Ziel, das jedoch kritisch ist: Eine Karte, die bald abläuft, muss vor einer fehlgeschlagenen Belastung erkannt werden. Eine fehlgeschlagene Rechnung ist nicht nur ein isoliertes finanzielles Ereignis – sie führt zur Dienstaussetzung, was im Kern eine Produktionsausfall in der Buchhaltung darstellt.

curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/payment-method" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Die Antwort enthält Informationen zu jeder Karte: Typ (Visa, Mastercard usw.), die letzten 4 Ziffern, das Ablaufdatum und den Status (aktiv, Standard).

Festlegen der Standardzahlungsmethode

Um die Karte zu ändern, die für automatische Belastungen verwendet wird:

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"
  }'

Die paymentMethodId ist der vom Anzeige-Endpunkt zurückgegebene Identifikator. Die Änderung tritt für kommende Belastungen in Kraft – nicht für solche, die bereits im Gange sind. Wenn sich der Status einer Rechnung in FAILED ändert, führt das Wechseln der Standardkarte nicht automatisch zu einer erneuten Prüfung: Korrigieren Sie die Zahlungsmethode und prüfen Sie dann den Status der betroffenen Rechnung.

Akzeptierte Karten

xAI akzeptiert eine breite Palette von Zahlungskarten für die API:

  • Visa
  • Mastercard
  • American Express (AMEX)
  • Discover
  • JCB
  • UnionPay

Wichtige Einschränkung: Indische Karten

Zahlungskarten, die in Indien ausgestellt wurden, werden nicht akzeptiert, um die xAI API zu nutzen. Diese Einschränkung gilt ausschließlich für die API – Zahlungen für den Verbraucher-Grok-Dienst (über grok.com oder mobile Apps) werden durch diese Beschränkung nicht betroffen.

Wenn Sie in Indien ansässig sind und die API nutzen möchten, müssen Sie eine in einem anderen Land ausgestellte Karte verwenden oder andere Zahlungsoptionen prüfen.

Best Practices für die Zahlungsverwaltung

Eine Reservekarte pflegen

Registrieren Sie mindestens zwei Zahlungsmethoden, vorzugsweise auf zwei verschiedenen Konten. Das von diesem Szenario abgedeckte Problem ist häufig und kostspielig: Die Firmenkarte wird ersetzt, niemand denkt daran, die API in die Liste der zu aktualisierenden Abonnements aufzunehmen, und der Dienst stoppt drei Wochen später. Eine fehlgeschlagene Zahlung (Status FAILED) kann zu einer vorübergehenden Aussetzung Ihrer API-Schlüssel führen.

Ablaufdaten überwachen

Prüfen Sie regelmäßig die Ablaufdaten Ihrer registrierten Karten. Aktualisieren Sie Karten, bevor sie ablaufen, um jegliche Unterbrechung zu vermeiden.

Zahlungsalarme

Kombinieren Sie das Anzeigen von Rechnungen (GET /invoices) mit einem Alarm-Skript:

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!")
        # Senden Sie eine Benachrichtigung (E-Mail, Slack usw.)

In Ihre Infrastruktur integrieren

Automatisierte Verifizierung

Integrieren Sie die periodische Verifizierung des Zahlungstatus in Ihre Überwachung:

# Monatliches Verifizierungsskript
#!/bin/bash
RESPONSE=$(curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/payment-method" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY")

# Prüfen, ob eine Standardkarte aktiv ist
echo "$RESPONSE" | python3 -c "
import sys, json
data = json.load(sys.stdin)
methods = data.get('paymentMethods', [])
if not methods:
    print('ALERT: keine Zahlungsmethode registriert')
    sys.exit(1)
default = [m for m in methods if m.get('isDefault')]
if not default:
    print('ALERT: keine Standardzahlungsmethode')
    sys.exit(1)
print('OK: Standardzahlungsmethode aktiv')
"

Kernaussagen

  • GET /v1/billing/teams/{teamId}/payment-method listet registrierte Karten auf
  • POST /v1/billing/teams/{teamId}/payment-method/default setzt die Standardkarte fest
  • Visa-, Mastercard-, AMEX-, Discover-, JCB- und UnionPay-Karten werden akzeptiert
  • Indische Karten werden nicht akzeptiert, um die API zu nutzen (funktionieren jedoch für grok.com)
  • Halten Sie immer mindestens zwei Karten registriert, um Unterbrechungen zu vermeiden
  • Überwachen Sie FAILED-Status in Ihren Rechnungen, um Zahlungsprobleme zu erkennen