Webhook cash_in - NTX Pay API

Cuándo se dispara

El webhook del tipo cash_in recibe los eventos del ciclo de vida de un cobro creado vía POST /api/spei/cash-in:

`event`	`status`	Significado
`transaction.cash_in.settled`	`LIQUIDATED`	La transferencia SPEI llegó a la CLABE desechable y fue liquidada
`transaction.cash_in.rejected`	`REJECTED`	La red SPEI rechazó la transferencia
`transaction.cash_in.expired`	`EXPIRED`	La CLABE expiró (~24h) sin recibir la transferencia
`transaction.cash_in.pending`	`PENDING`	Actualización intermedia de procesamiento

La devolución de un cash-in ya liquidado (transaction.cash_in.returned) se entrega en el webhook del tipo refund_in, no en el cash_in.

Payload

{
  "event": "transaction.cash_in.settled",
  "transactionId": "12345",
  "amount": 50000,
  "currency": "MXN",
  "status": "LIQUIDATED",
  "destinationClabe": "012180001234567890",
  "sourceClabe": "646180123456789012",
  "payerName": "Juan Perez",
  "reference": "1234567",
  "voucher": "CEP20260512A1B2C3",
  "occurredAt": "2026-05-12T14:31:05.000Z"
}

destinationClabe — la CLABE desechable emitida al crear el cobro
sourceClabe — la CLABE del pagador (cuando la red la informa)
amount — monto en centavos MXN
Los campos de referencia (reference, voucher) pueden venir null dependiendo del flujo

Headers

Header	Valor
`x-event-id`	UUID único del evento (úsalo para dedupe)
`X-NTXPay-Signature`	`sha256=<hmac>` del cuerpo crudo

Respuesta Esperada

Responde 200 OK en menos de 10 segundos. Ante cualquier status distinto de 2xx, NTX Pay reintenta hasta 5 veces con backoff exponencial.

HTTP/1.1 200 OK
Content-Type: application/json

{"received": true}

Procesamiento

Marca la orden como pagada solamente cuando event sea transaction.cash_in.settled (o status: LIQUIDATED):

const event = JSON.parse(rawBody.toString());
if (event.event === 'transaction.cash_in.settled') {
  await markOrderPaid(event.transactionId, event.amount);
}

Para el handler completo con validación HMAC y dedupe en Node.js, Python, Java y Go, consulta Implementación.