Skip to main content

Webhook y/o evento de API cuando falla la validación o el guardado de una tarjeta

Problema Cuando un cliente carga o actualiza su tarjeta y la validación es rechazada, nuestra integración no recibe ninguna notificación. El rechazo puede venir de la entidad emisora o de los controles de seguridad del procesador. Nos enteramos días después cuando el cliente nos escribe.

Entre el 28/09 y el 20/10 tuvimos 46 validaciones rechazadas. No pudimos avisar a tiempo a ninguno de esos clientes. Varios reintentaron muchas veces seguidas y terminaron bloqueados por los controles del procesador.

Qué pedimos

  1. Un evento de webhook (por ejemplo payment_method.validation_failed) que se dispare en cada validación o guardado de tarjeta rechazado.

  2. Un endpoint de API para consultar los intentos fallidos de un cliente o de una suscripción.

Datos mínimos del evento

  • ID del cliente y de la suscripción

  • Fecha y hora del intento

  • Origen del rechazo: entidad emisora o control de seguridad del procesador

  • Código y mensaje de rechazo

  • Marca y últimos 4 dígitos de la tarjeta

  • Número de intento, para detectar reintentos seguidos

Para qué lo usaríamos

  • Avisar al cliente en el momento, desde nuestro producto

  • Sugerirle otra tarjeta antes de que reintente varias veces

  • Evitar que los reintentos seguidos activen los controles del procesador

1 comment

Log in to comment and vote

Comments1

  • santi.podesta.c

    •

    Oct 27

    Problem When a customer adds or updates their card and the validation is rejected, our integration receives no notification. The rejection can come from the issuing bank or from the processor's security checks. We only find out days later, when a charge fails or when the customer reaches out to us.

    Between 09/28 and 10/20 we had 46 rejected validations. We couldn't warn any of those customers in time. Several of them retried many times in a row and ended up blocked by the processor's security checks.

    What we're asking for

    1. A webhook event (e.g. payment_method.validation_failed) fired on every rejected card validation or save.

    2. An API endpoint to query failed attempts for a customer or a subscription.

    Minimum event payload

    • Customer ID and subscription ID

    • Date and time of the attempt

    • Rejection source: issuing bank or processor security check

    • Rejection code and message

    • Card brand and last 4 digits

    • Attempt number, to detect repeated retries

    How we'd use it

    • Notify the customer right away, from inside our product

    • Suggest a different card before they retry several times

    • Prevent repeated retries from triggering the processor's security checks