Se rechazó un pago con tarjeta que tu usuario inició desde el portal.
Se dispara cuando se rechaza un pago con tarjeta que inició tu usuario final.
El type de este evento es CARD_PAYMENT_STATUS, no CARD_PAYMENT_FAILED. El nombre es genérico a propósito, para poder reutilizarlo más adelante con confirmaciones y otros estados. Hoy el único caso que lo emite es el pago rechazado, así que status vale siempre "FAILED".
Enruta por type y después ramifica por status. Así tu handler sigue funcionando el día que este mismo type empiece a traer otros estados.
Monto del pago. La clave siempre viene; el valor es null si el evento no lo informa.
companyCode
String | null
Siempre
Código de la empresa. Mismo criterio que amount.
companyName
String | null
Siempre
Nombre de la empresa. Mismo criterio que amount.
additionalData
Object
Condicional
Detalle del error del proveedor. Se omite entero si queda vacío.
additionalData.errorDetail.code
String
Condicional
Código de error del proveedor.
additionalData.errorDetail.message
String
Condicional
Mensaje de error del proveedor.
hash
String | null
Siempre
Hash de verificación. null si no tienes llave pública configurada.
El detalle del error va anidado en additionalData.errorDetail, un nivel más adentro que en domiciliación con tarjeta fallida, donde va directo en additionalData. Es la única diferencia de forma entre los dos eventos de tarjeta.
additionalDatase omite por completo cuando no hay detalle que enviar: cuando sendErrorInfo está apagado en tu configuración, y también cuando está prendido pero el evento no trae detalle del proveedor.
// Correcto: contempla los dos niveles opcionalesconst codigo = notificacion.additionalData?.errorDetail?.code ?? null;
