Métodos de Pagamento
Nesta página
Gerir os seus métodos de pagamento
A Management API permite-lhe visualizar os cartões registados e definir o método de pagamento predefinido para cobranças automáticas. Esta gestão é essencial para evitar interrupções de serviço causadas por pagamentos falhados.
Visualizar métodos de pagamento
A gestão de cartões através da API tem um objetivo prático, mas crítico: detetar um cartão prestes a expirar antes que uma cobrança falhe. Uma fatura falhada não é apenas um incidente financeiro isolado; leva à suspensão do serviço, essencialmente uma paragem de produção originada na contabilidade.
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/payment-method" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
A resposta contém informações para cada cartão: tipo (Visa, Mastercard, etc.), os últimos 4 dígitos, a data de validade e o estado (ativo, predefinido).
Definir o método de pagamento predefinido
Para alterar o cartão utilizado para cobranças automáticas:
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"
}'
O paymentMethodId é o identificador devolvido pelo endpoint de visualização. A alteração entra em vigor para as próximas cobranças, não para as que já estão em curso. Se o estado de uma fatura mudar para FAILED, alterar o cartão predefinido não a reenvia automaticamente: corrija o método de pagamento e, em seguida, verifique o estado da fatura afetada.
Cartões aceites
A xAI aceita uma vasta gama de cartões de pagamento para a API:
- Visa
- Mastercard
- American Express (AMEX)
- Discover
- JCB
- UnionPay
Restrição importante: cartões indianos
Os cartões de pagamento emitidos na Índia não são aceites para utilizar a API da xAI. Esta restrição aplica-se apenas à API; os pagamentos para o serviço de consumo Grok (via grok.com ou aplicações móveis) não são afetados por esta limitação.
Se estiver sediado na Índia e quiser utilizar a API, deve utilizar um cartão emitido noutro país ou explorar outras opções de pagamento.
Melhores práticas de gestão de pagamentos
Manter um cartão de reserva
Registe pelo menos dois métodos de pagamento, de preferência em duas contas diferentes. O cenário que isto cobre é comum e dispendioso: o cartão da empresa é substituído, ninguém se lembra de incluir a API na lista de subscrições a atualizar e o serviço para três semanas depois. Um pagamento falhado (estado FAILED) pode levar à suspensão temporária das suas chaves de API.
Monitorizar validades
Verifique regularmente as datas de validade dos seus cartões registados. Atualize os cartões antes de expirarem para evitar qualquer interrupção.
Alertas de pagamento
Combine a visualização de faturas (GET /invoices) com um script de alerta:
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.)
Integrar na sua infraestrutura
Verificação automatizada
Integre a verificação periódica do estado dos pagamentos na sua monitorização:
# 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')
"
Pontos-chave
GET /v1/billing/teams/{teamId}/payment-methodlista os cartões registadosPOST /v1/billing/teams/{teamId}/payment-method/defaultdefine o cartão predefinido- São aceites cartões Visa, Mastercard, AMEX, Discover, JCB e UnionPay
- Cartões indianos não são aceites para a API (mas funcionam para grok.com)
- Mantenha sempre pelo menos dois cartões registados para evitar interrupções
- Monitore os estados FAILED nas suas faturas para detetar problemas de pagamento