Moyens de paiement

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

La gestion des cartes par l’API n’a qu’un seul but pratique, mais il est décisif : détecter une carte sur le point d’expirer avant qu’un prélèvement échoue. Une facture en échec n’est pas un incident financier isolé — elle conduit à la suspension du service, c’est-à-dire à une panne de production dont l’origine se trouve chez le comptable.

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, et le changement prend effet pour les prochains prélèvements — pas pour ceux déjà en cours. Si une facture est passée en FAILED, basculer la carte par défaut ne la relance pas automatiquement : corrigez le moyen de paiement, puis vérifiez le statut de la facture concernée.

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, et de préférence sur deux comptes différents. Le scénario que cela couvre est banal et coûteux : la carte de l’entreprise est remplacée, personne ne pense à l’API dans la liste des abonnements à mettre à jour, et le service s’arrête trois semaines plus tard. 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