Saltar al contenido principal

​
Visión General

El SPEI cash-in genera una CLABE desechable que el pagador usa para realizar una transferencia SPEI desde su app bancaria. Cuando NTX Pay recibe la liquidación, la transacción pasa a CONFIRMED y dispara el webhook cash_in. Características:
  • CLABE válida para una sola transferencia (one-time use)
  • Confirmación asíncrona (segundos a minutos)
  • Expira en fecha configurable (default ~24 horas)

​
Endpoint

​
POST /api/spei/cash-in

​
Headers

Authorization: Bearer {token}
Content-Type: application/json

​
Request

curl -X POST https://sandbox.mx.ntxpay.com/api/spei/cash-in \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "amountCentavos": 50000,
    "externalId": "order-abc-123",
    "description": "Pedido #123",
    "customerName": "Juan Perez",
    "customerEmail": "juan@example.com",
    "customerTaxId": "PEPJ800101ABC"
  }'

​
Response (201)

{
  "id": 12345,
  "status": "PENDING",
  "destinationClabe": "012180001234567890",
  "beneficiary": {
    "name": "NTX Pay MX",
    "taxId": "NTX800101ABC"
  },
  "referenceNumerical": "1234567",
  "checkoutUrl": "https://pay.ntxpay.com/checkout/xyz",
  "expiresAt": "2026-05-14T23:59:59.000Z",
  "amountCentavos": 50000
}

​
Campos del Request

​
amountCentavos
integer
requerido
Valor en centavos MXN (mínimo 1). Ej.: 50000 = $500.00 MXN.
​
externalId
string
Identificador externo único (hasta 100 caracteres). Úsalo para correlacionar con tu sistema. Recomendado para idempotencia.
​
description
string
Descripción del cobro (hasta 255 caracteres).
​
customerName
string
requerido
Nombre del pagador (1–255 caracteres), mostrado en el checkout SPEI.
​
customerEmail
string
requerido
Email del pagador (formato de email válido).
​
customerTaxId
string
RFC/CURP del pagador (10–20 caracteres).

​
Flujo de Pago

​
Estados de la Transacción

StatusSignificado
PENDINGCLABE emitida, esperando transferencia
CONFIRMEDTransferencia recibida y liquidada
FAILEDError en el procesamiento
EXPIREDCLABE expiró sin recibir transferencia

​
Idempotencia

Reenvía la misma request con el mismo externalId para garantizar que un fallo de red no genere dos cobros. En caso de duplicidad, NTX Pay retorna el cobro existente.

​
Próximos Pasos

Webhook cash_in

Detalles del payload del webhook de confirmación

SPEI Cash-Out

Envía transferencias SPEI