Domiciliación con tarjeta fallida

Se dispara cuando falla el cobro automático recurrente contra la tarjeta que tu usuario tiene adherida. Es el equivalente con tarjeta del débito bancario fallido.

Es un cobro que inició TapiPay por la domiciliación, no tu usuario. Para el pago que tu usuario inicia desde el portal, el evento es pago con tarjeta fallido.


`type`	`CARD_AUTOPAY_FAILED`
`status`	Siempre `"FAILED"`
Llave de idempotencia	`operationId`

El payload

Campo	Tipo	Presente	Descripción
`type`	String	Siempre	Siempre `"CARD_AUTOPAY_FAILED"`.
`operationId`	String	Siempre	Identificador de la operación de domiciliación.
`status`	String	Siempre	Siempre `"FAILED"`.
`amount`	Number	Siempre	Monto que se intentó cobrar.
`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`.
`additionalData`	Object	Condicional	Detalle del error del proveedor. Se omite entero si queda vacío.
`additionalData.errorCode`	String	Condicional	Código de error del proveedor.
`additionalData.errorMessage`	String	Condicional	Mensaje de error del proveedor.
`hash`	String \| null	Siempre	Hash de verificación. `null` si no tienes llave pública configurada.

Cuándo llega `additionalData`

Cuando no hay detalle de error que enviar, la clave additionalData no está en el payload. No llega vacía ni con null adentro. Léela siempre con acceso opcional.

Queda omitida en dos casos:

sendErrorInfo está apagado en tu configuración.
Está prendido, pero el proveedor no informó ni errorCode ni errorMessage.

Si el proveedor informó solo uno de los dos, additionalData llega con ese único campo.

sendErrorInfo se define solo en tu configuración, durante el onboarding. No es algo que pueda activarse desde el evento.

Ejemplos

{
  "type": "CARD_AUTOPAY_FAILED",
  "operationId": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
  "status": "FAILED",
  "amount": 8000,
  "companyCode": "MX-S-12345",
  "companyName": "ACME",
  "additionalData": {
    "errorCode": "INSUFFICIENT_FUNDS",
    "errorMessage": "La tarjeta no tiene fondos suficientes"
  },
  "hash": "encrypted-base64-string"
}

{
  "type": "CARD_AUTOPAY_FAILED",
  "operationId": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
  "status": "FAILED",
  "amount": 8000,
  "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

Domiciliación con tarjeta fallida

El payload

Cuándo llega `additionalData`

Ejemplos

Campos comunes, hash e idempotencia

​El payload

​Cuándo llega additionalData

​Ejemplos

Campos comunes, hash e idempotencia

El payload

Cuándo llega `additionalData`

Ejemplos