Ir al contenido principal
Español— Elegir un idioma
Menú

Métodos de pago

Lección 6 de 14 Actualizado el 29 de julio de 2026 Desarrollador
En esta página
  1. Gestión de tus métodos de pago
  2. Consulta de métodos de pago
  3. Establecimiento del método de pago predeterminado
  4. Tarjetas aceptadas
  5. Mejores prácticas de gestión de pagos
  6. Integración en tu infraestructura
  7. Puntos clave

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-method lista las tarjetas registradas
  • POST /v1/billing/teams/{teamId}/payment-method/default establece 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