Recibe una notificación cuando cambie el método de pago de un cliente

Si tu integración muestra las suscripciones y el estado de los pagos en tu propio sistema, ahora puede recibir un webhook cuando cambie el método de pago de un cliente. Ya no hace falta consultar repetidamente los métodos de pago para detectar cambios.

Se añaden tres eventos para el propio método de pago:

• payment_method.created: cuando se guarda un método de pago con tarjeta o SEPA, por ejemplo, durante el checkout, en el portal de clientes o mediante la API.
• payment_method.updated: cuando el método de pago pasa a ser el predeterminado del cliente, recibe una nueva fecha de caducidad o deja de poder utilizarse.
• payment_method.deleted: cuando se elimina el método de pago.

Cada evento contiene el método de pago exactamente como lo devuelve la API: la marca de la tarjeta, los últimos cuatro dígitos, la fecha de caducidad e información sobre si es el método predeterminado y se puede usar. Nunca se incluyen los números completos de la tarjeta.

Las suscripciones ahora también indican con qué método de pago se cobran: payment_method_uuid aparece en la API y en todos los webhooks de suscripción. El nuevo evento subscription.payment_method_changed avisa a tu integración cuando cambia el método; por ejemplo, si el cliente sustituye la tarjeta tras un pago fallido.

Cuando la aplicación API esté habilitada, activa los eventos en la configuración de webhooks y envía primero una muestra de prueba al receptor. Las integraciones instaladas también pueden suscribirse a estos eventos.

No se envía ningún evento solo porque una tarjeta haya llegado a su fecha de caducidad. En su lugar, consulta is_expired y is_usable en el método de pago.