Contracargo de débito bancario

Se dispara cuando el banco revierte un débito bancario que ya se había confirmado. El dinero se había cobrado y volvió a la cuenta de tu usuario.

Este evento llega sobre un cobro que ya diste por bueno. Si marcaste la deuda como pagada cuando se confirmó el débito, aquí tienes que revertir ese estado en tu sistema.


`type`	`AUTO_DEBIT_CHARGEBACK`
`status`	No aplica: este evento no trae `status`
Llave de idempotencia	`operationId`

El payload

Campo	Tipo	Presente	Descripción
`type`	String	Siempre	Siempre `"AUTO_DEBIT_CHARGEBACK"`.
`operationId`	String	Siempre	Identificador único del débito bancario revertido.
`originalStatus`	String	Siempre	Estado del débito antes del contracargo. Normalmente `"CONFIRMED"`.
`chargebackReason`	String \| null	Variable	Motivo del contracargo, en texto libre del banco. `null` cuando el banco no informa motivo.
`chargebackDate`	String	Siempre	Fecha del contracargo, en ISO 8601.
`amount`	Number	Siempre	Monto revertido.
`bank`	String	Siempre	Nombre del banco.
`accountLast4`	String \| null	Variable	Últimos 4 dígitos de la cuenta o CLABE. `null` cuando el banco no lo informa.
`companyCode`	String \| null	Siempre	Código de la empresa. La clave siempre viene; el valor puede ser `null`.
`companyName`	String \| null	Siempre	Nombre de la empresa. Mismo criterio que `companyCode`.
`hash`	String \| null	Siempre	Hash de verificación. `null` si no tienes llave pública configurada.

chargebackReason es texto libre, tal como lo informó el banco. No se valida contra un catálogo ni se normaliza, así que su redacción puede variar. No lo uses como llave de tu lógica: muéstralo o regístralo, pero no hagas switch sobre su contenido.

originalStatus también es texto libre del productor. El valor habitual es "CONFIRMED".

El contracargo de tarjeta funciona distinto en este punto: ahí el motivo sí es un catálogo cerrado.

Ejemplos

{
  "type": "AUTO_DEBIT_CHARGEBACK",
  "operationId": "d3b1f2a0-1234-4a5b-8c9d-0e1f2a3b4c5d",
  "originalStatus": "CONFIRMED",
  "chargebackReason": "Cargo desconocido por el titular",
  "chargebackDate": "2026-07-10T09:00:00Z",
  "amount": 150000,
  "bank": "Santander",
  "accountLast4": "4321",
  "companyCode": "MX-S-12345",
  "companyName": "ACME",
  "hash": "encrypted-base64-string"
}

{
  "type": "AUTO_DEBIT_CHARGEBACK",
  "operationId": "d3b1f2a0-1234-4a5b-8c9d-0e1f2a3b4c5d",
  "originalStatus": "CONFIRMED",
  "chargebackReason": null,
  "chargebackDate": "2026-07-10T09:00:00Z",
  "amount": 150000,
  "bank": "Santander",
  "accountLast4": null,
  "companyCode": "MX-S-12345",
  "companyName": "ACME",
  "hash": null
}

Campos comunes, hash e idempotencia

Lo que comparten todos los webhooks de esta familia.

Empieza aquí

Novedades

Conceptos

Recursos

Portal de pagos

Webhooks

Contracargo de débito bancario

El payload

Ejemplos

Campos comunes, hash e idempotencia

​El payload

​Ejemplos

Campos comunes, hash e idempotencia

El payload

Ejemplos