Métodos de pago
En esta página
Gestión de tus métodos de pago
La API de Management te permite consultar las tarjetas registradas y establecer el método de pago predeterminado para los cargos automáticos. Gestionar esto es esencial para evitar interrupciones del servicio provocadas por pagos fallidos.
Consulta de métodos de pago
La gestión de tarjetas mediante la API tiene un objetivo práctico, pero crítico: detectar una tarjeta a punto de caducar antes de que falle un cargo. Una factura fallida no es solo un incidente financiero aislado; provoca la suspensión del servicio, lo que equivale esencialmente a una caída en producción originada en el departamento de contabilidad.
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/payment-method" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
La respuesta contiene información de cada tarjeta: tipo (Visa, Mastercard, etc.), los últimos 4 dígitos, la fecha de caducidad y el estado (activa, predeterminada).
Establecimiento del método de pago predeterminado
Para cambiar la tarjeta utilizada para los cargos automáticos:
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"
}'
El paymentMethodId es el identificador devuelto por el endpoint de consulta. El cambio surte efecto para los próximos cargos, no para aquellos que ya estén en curso. Si el estado de una factura cambia a FAILED, cambiar la tarjeta predeterminada no reintenta el cobro automáticamente: corrige el método de pago y, a continuación, verifica el estado de la factura afectada.
Tarjetas aceptadas
xAI acepta una amplia gama de tarjetas de pago para la API:
- Visa
- Mastercard
- American Express (AMEX)
- Discover
- JCB
- UnionPay
Restricción importante: tarjetas indias
Las tarjetas de pago emitidas en la India no se aceptan para utilizar la API de xAI. Esta restricción se aplica únicamente a la API; los pagos del servicio de consumo Grok (a través de grok.com o aplicaciones móviles) no se ven afectados por esta limitación.
Si resides en la India y deseas utilizar la API, debes emplear una tarjeta emitida en otro país o explorar otras opciones de pago.
Mejores prácticas de gestión de pagos
Mantén una tarjeta de respaldo
Registra al menos dos métodos de pago, preferiblemente en dos cuentas diferentes. El escenario que esto cubre es común y costoso: la tarjeta de la empresa se sustituye, nadie piensa en incluir la API en la lista de suscripciones a actualizar y el servicio se detiene tres semanas después. Un pago fallido (estado FAILED) puede provocar la suspensión temporal de tus claves de API.
Supervisa las caducidades
Revisa periódicamente las fechas de caducidad de tus tarjetas registradas. Actualiza las tarjetas antes de que caduquen para evitar cualquier interrupción.
Alertas de pago
Combina la consulta de facturas (GET /invoices) con un 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"ALERTA: la factura {invoice['id']} ha fallado!")
# Envía una notificación (correo electrónico, Slack, etc.)
Integración en tu infraestructura
Verificación automatizada
Integra la verificación periódica del estado de los pagos en tu monitorización:
# Script de verificación mensual
#!/bin/bash
RESPONSE=$(curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/payment-method" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY")
# Comprueba si hay una tarjeta predeterminada activa
echo "$RESPONSE" | python3 -c "
import sys, json
data = json.load(sys.stdin)
methods = data.get('paymentMethods', [])
if not methods:
print('ALERTA: no hay ningún método de pago registrado')
sys.exit(1)
default = [m for m in methods if m.get('isDefault')]
if not default:
print('ALERTA: no hay ningún método de pago predeterminado')
sys.exit(1)
print('CORRECTO: método de pago predeterminado activo')
"
Puntos clave
GET /v1/billing/teams/{teamId}/payment-methodlista las tarjetas registradasPOST /v1/billing/teams/{teamId}/payment-method/defaultestablece la tarjeta predeterminada- Se aceptan tarjetas Visa, Mastercard, AMEX, Discover, JCB y UnionPay
- Las tarjetas indias no se aceptan para la API (pero funcionan para grok.com)
- Mantén siempre al menos dos tarjetas registradas para evitar interrupciones
- Supervisa los estados FAILED en tus facturas para detectar problemas de pago