Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Métodos de Pagamento

Aula 6 de 14 Atualizada a 29 de julho de 2026 Programador
Nesta página
  1. Gerir os seus métodos de pagamento
  2. Visualizar métodos de pagamento
  3. Definir o método de pagamento predefinido
  4. Cartões aceites
  5. Melhores práticas de gestão de pagamentos
  6. Integrar na sua infraestrutura
  7. Pontos-chave

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-method lista os cartões registados
  • POST /v1/billing/teams/{teamId}/payment-method/default define 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