Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Metodi di pagamento

Lezione 6 di 14 Aggiornata il 29 luglio 2026 Sviluppatore
In questa pagina
  1. Gestisci i tuoi metodi di pagamento
  2. Visualizza i metodi di pagamento
  3. Imposta il metodo di pagamento predefinito
  4. Carte accettate
  5. Best practice per la gestione dei pagamenti
  6. Integra nella tua infrastruttura
  7. Punti chiave

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-method elenca le carte registrate
  • POST /v1/billing/teams/{teamId}/payment-method/default imposta 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