Metodi di pagamento
In questa pagina
Gestisci i tuoi metodi di pagamento
L’API di Management ti consente di visualizzare le carte registrate e impostare il metodo di pagamento predefinito per gli addebiti automatici. Gestire questo aspetto è essenziale per evitare interruzioni del servizio causate da pagamenti falliti.
Visualizza i metodi di pagamento
La gestione delle carte tramite API ha un obiettivo pratico, ma critico: rilevare una carta in procinto di scadere prima che un addebito fallisca. Una fattura non pagata non è solo un incidente finanziario isolato: porta alla sospensione del servizio, essenzialmente un’interruzione della produzione originata in ambito contabile.
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/payment-method" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
La risposta contiene informazioni per ogni carta: tipo (Visa, Mastercard, ecc.), le ultime 4 cifre, la data di scadenza e lo stato (attiva, predefinita).
Imposta il metodo di pagamento predefinito
Per cambiare la carta utilizzata per gli addebiti automatici:
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"
}'
Il paymentMethodId è l’identificatore restituito dall’endpoint di visualizzazione. La modifica ha effetto per gli addebiti futuri, non per quelli già in corso. Se lo stato di una fattura cambia in FAILED, cambiare la carta predefinita non ritenta automaticamente il pagamento: correggi prima il metodo di pagamento, poi verifica lo stato della fattura interessata.
Carte accettate
xAI accetta un’ampia gamma di carte di pagamento per l’API:
- Visa
- Mastercard
- American Express (AMEX)
- Discover
- JCB
- UnionPay
Restrizione importante: carte indiane
Le carte di pagamento emesse in India non sono accettate per l’utilizzo dell’API xAI. Questa restrizione si applica solo all’API: i pagamenti per il servizio consumer Grok (tramite grok.com o app mobili) non sono soggetti a questa limitazione.
Se risiedi in India e desideri utilizzare l’API, devi usare una carta emessa in un altro paese o esplorare altre opzioni di pagamento.
Best practice per la gestione dei pagamenti
Mantieni una carta di backup
Registra almeno due metodi di pagamento, preferibilmente su due account diversi. Lo scenario che questo copre è comune e costoso: la carta aziendale viene sostituita, nessuno pensa di includere l’API nell’elenco degli abbonamenti da aggiornare e il servizio si interrompe tre settimane dopo. Un pagamento fallito (stato FAILED) può portare alla sospensione temporanea delle tue chiavi API.
Monitora le scadenze
Controlla regolarmente le date di scadenza delle tue carte registrate. Aggiorna le carte prima che scadano per evitare qualsiasi interruzione.
Avvisi di pagamento
Combina la visualizzazione delle fatture (GET /invoices) con uno script di avviso:
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.)
Integra nella tua infrastruttura
Verifica automatizzata
Integra la verifica periodica dello stato dei pagamenti nel tuo monitoraggio:
# 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')
"
Punti chiave
GET /v1/billing/teams/{teamId}/payment-methodelenca le carte registratePOST /v1/billing/teams/{teamId}/payment-method/defaultimposta la carta predefinita- Sono accettate carte Visa, Mastercard, AMEX, Discover, JCB e UnionPay
- Le carte indiane non sono accettate per l’API (ma funzionano per grok.com)
- Mantieni sempre almeno due carte registrate per evitare interruzioni
- Monitora gli stati FAILED nelle tue fatture per rilevare problemi di pagamento