Contracargo de tarjeta

Se dispara cuando el proveedor de pagos informa un contracargo sobre una orden ya procesada: el titular de la tarjeta desconoció el cargo o su banco lo revirtió.

Este evento llega sobre un cobro que ya diste por bueno. Si marcaste la deuda como pagada, aquí tienes que revertir ese estado en tu sistema.


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

El payload

Campo	Tipo	Presente	Descripción
`type`	String	Siempre	Siempre `"CARD_PAYMENT_CHARGEBACK"`.
`operationId`	String	Siempre	Identificador de la orden afectada.
`chargebackReason`	String \| null	Variable	Motivo del contracargo, del catálogo cerrado de abajo. `null` cuando el proveedor no informa motivo.
`chargebackDate`	String	Siempre	Fecha del contracargo, en ISO 8601.
`amount`	Number	Siempre	Monto del contracargo.
`currency`	String	Siempre	Moneda del contracargo, por ejemplo `"MXN"`.
`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.

Este payload no trae status, porque un contracargo no describe el estado de un pago sino un hecho posterior sobre un cargo ya procesado. Tampoco trae bank: eso es de los eventos de débito bancario.

Motivos del contracargo

chargebackReason es un catálogo cerrado, a diferencia del contracargo de débito bancario, donde es texto libre. Puedes ramificar tu lógica sobre estos valores con confianza. Los valores posibles son FRAUD, DUPLICATE, NOT_AS_DESCRIBED, NOT_RECEIVED y UNRECOGNIZED. El motivo lo informa el proveedor de pagos.

El motivo llega siempre en mayúsculas, en su forma canónica, sin importar cómo lo haya escrito el proveedor. Un motivo fuera del catálogo se rechaza en validación y la notificación no se entrega, así que nunca vas a recibir un valor inesperado en este campo. Lo que sí puede llegar es null.

Ejemplos

{
  "type": "CARD_PAYMENT_CHARGEBACK",
  "operationId": "ORD-88888",
  "chargebackReason": "FRAUD",
  "chargebackDate": "2026-07-09T14:30:00Z",
  "amount": 25000,
  "currency": "MXN",
  "companyCode": "MX-S-12345",
  "companyName": "ACME",
  "hash": "encrypted-base64-string"
}

{
  "type": "CARD_PAYMENT_CHARGEBACK",
  "operationId": "ORD-88888",
  "chargebackReason": null,
  "chargebackDate": "2026-07-09T14:30:00Z",
  "amount": 25000,
  "currency": "MXN",
  "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 tarjeta

El payload

Motivos del contracargo

Ejemplos

Campos comunes, hash e idempotencia

​El payload

​Motivos del contracargo

​Ejemplos

Campos comunes, hash e idempotencia

El payload

Motivos del contracargo

Ejemplos