Moyens de paiement — Management API : clés & facturation

Gérer vos moyens de paiement

La Management API permet de consulter les cartes enregistrées et de définir le moyen de paiement par défaut pour les prélèvements automatiques. Cette gestion est essentielle pour éviter les interruptions de service dues à un paiement échoué.

Consulter les moyens de paiement

Pour lister les cartes enregistrées pour votre équipe :

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

La réponse contient les informations de chaque carte : type (Visa, Mastercard, etc.), les 4 derniers chiffres, la date d’expiration et le statut (actif, par défaut).

Définir le moyen de paiement par défaut

Pour changer la carte utilisée pour les prélèvements automatiques :

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

Le paymentMethodId est l’identifiant retourné par l’endpoint de consultation. Le changement est effectif immédiatement pour les prochains prélèvements.

Cartes acceptées

xAI accepte un large éventail de cartes bancaires pour l’API :

Visa
Mastercard
American Express (AMEX)
Discover
JCB
UnionPay

Restriction importante : cartes indiennes

Les cartes de paiement émises en Inde ne sont pas acceptées pour l’utilisation de l’API xAI. Cette restriction concerne uniquement l’API — les paiements pour le service grand public Grok (via grok.com ou les applications mobiles) ne sont pas affectés par cette limitation.

Si vous êtes basé en Inde et souhaitez utiliser l’API, vous devrez utiliser une carte émise dans un autre pays ou explorer d’autres options de paiement.

Bonnes pratiques de gestion des paiements

Maintenir une carte de secours

Enregistrez au moins deux moyens de paiement pour votre équipe. Si la carte principale expire ou est refusée, la seconde peut prendre le relais. Un paiement échoué (statut FAILED) peut entraîner la suspension temporaire de vos clés API.

Surveiller les expirations

Vérifiez régulièrement les dates d’expiration de vos cartes enregistrées. Mettez à jour les cartes avant leur expiration pour éviter toute interruption.

Alertes de paiement

Combinez la consultation des factures (GET /invoices) avec un script d’alerte :

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"ALERTE : facture {invoice['id']} en échec !")
        # Envoyer une notification (email, Slack, etc.)

Intégration dans votre infrastructure

Vérification automatique

Intégrez une vérification périodique de l’état des paiements dans votre monitoring :

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

# Vérifier si une carte par défaut est active
echo "$RESPONSE" | python3 -c "
import sys, json
data = json.load(sys.stdin)
methods = data.get('paymentMethods', [])
if not methods:
    print('ALERTE : aucun moyen de paiement enregistré')
    sys.exit(1)
default = [m for m in methods if m.get('isDefault')]
if not default:
    print('ALERTE : aucun moyen de paiement par défaut')
    sys.exit(1)
print('OK : moyen de paiement par défaut actif')
"

Points clés à retenir

GET /v1/billing/teams/{teamId}/payment-method liste les cartes enregistrées
POST /v1/billing/teams/{teamId}/payment-method/default définit la carte par défaut
Les cartes Visa, Mastercard, AMEX, Discover, JCB et UnionPay sont acceptées
Les cartes indiennes ne sont pas acceptées pour l’API (mais fonctionnent pour grok.com)
Maintenez toujours au moins deux cartes enregistrées pour éviter les interruptions
Surveillez les statuts FAILED dans vos factures pour détecter les problèmes de paiement