Webhook refund_in - NTX Pay API

Quando dispara

O webhook do tipo refund_in recebe o evento transaction.cash_in.returned: um cash-in que você recebeu foi devolvido ao pagador. O saldo correspondente é debitado da sua conta. Cenários comuns:

Estorno por motivo de fraude ou erro
Devolução dentro do prazo da rede SPEI

Payload

{
  "event": "transaction.cash_in.returned",
  "transactionId": "12345",
  "amount": 50000,
  "currency": "MXN",
  "status": "RETURNED",
  "destinationClabe": "012180001234567890",
  "sourceClabe": "646180123456789012",
  "reference": "1234567",
  "voucher": null,
  "occurredAt": "2026-05-14T11:45:00.000Z"
}

O transactionId é o mesmo do cash-in original — use-o para localizar o pedido e marcá-lo como estornado.

Headers

Header	Valor
`x-event-id`	UUID único do evento (use para dedupe)
`X-NTXPay-Signature`	`sha256=<hmac>` do corpo bruto

Resposta Esperada

200 OK em até 10 segundos.

Processamento

const event = JSON.parse(rawBody.toString());
if (event.event === 'transaction.cash_in.returned') {
  // O débito do saldo já aconteceu automaticamente
  await markOrderRefunded(event.transactionId, event.amount);
}

Para o handler completo com validação HMAC e dedupe em Node.js, Python, Java e Go, veja Implementação.