Documentación

Crea un cobro, comparte la página de pago y recibe un webhook cuando llegue la transferencia SPEI. Todas las cuentas inician en modo de prueba: las transferencias se simulan desde la página de pago.

1. Autenticación

Genera tus claves en Panel → Claves API. Envía la clave secreta en el encabezado Authorization: Bearer sk_test_…. Úsala solo desde tu servidor.

2. Crear un cobro SPEI

POST /v1/payments genera una CLABE única de 18 dígitos y una referencia numérica. Comisión: 8 MXN por pago recibido.

curl -X POST https://TU-DOMINIO/api/public/v1/payments \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"amount_mxn": 850, "description": "Pedido #1042", "customer_email": "cliente@correo.mx"}'

Respuesta

{
  "id": "6f1c0e2a-…",
  "status": "pending",
  "amount_mxn": 850,
  "clabe": "646180123456789012",
  "reference": "4820193",
  "bank_name": "STP",
  "expires_at": "2026-10-17T00:00:00Z",
  "livemode": false,
  "checkout_url": "https://TU-DOMINIO/pay/6f1c0e2a-…"
}

3. Verificar webhooks

Enviamos payment.created y payment.paid a tus endpoints. Verifica siempre la firma con tu secreto whsec_… antes de marcar un pedido como pagado.

# Encabezado que enviamos en cada webhook:
# Wiredx-Signature: t=1760400000,v1=<hmac_sha256_hex>
# Firma = HMAC_SHA256(whsec_..., "<t>.<cuerpo_crudo>")

4. Estados del pago

pending — Pendiente: esperando la transferencia.
paid — Pagado: SPEI recibido, incluye clave de rastreo.
expired — Expirado: pasaron 72 horas sin recibir el pago.