GoCardless mandate_replaced: el mandato tiene un sustituto

Qué dice GoCardless

La documentación de eventos lo explica así: «The mandate has been cancelled and replaced by a new mandate (for example, because the creditor has moved to a new Service User Number).». Y lo que trae el evento: «The event will include links[new_mandate] with the ID of the new mandate.».

mandate_replaced es un error invalid_state: la acción no vale en el estado actual del recurso. Para esos errores GoCardless pide avisar al usuario y no reintentar («invalid_state → inform the end user, do not allow retry.»).

Cuándo aparece

El cambio no lo provoca el cliente ni su banco: el evento replaced tiene origen gocardless, y la causa documentada es que el acreedor, la cuenta con la que cobras en GoCardless, ha pasado a otro identificador de esquema. GoCardless cancela el mandato viejo y crea uno nuevo en su lugar.

mandate_replaced solo aparece si Odoo intenta cobrar con el mandato viejo: el cobro de una suscripción que se renueva, o un pago registrado con el método de pago guardado del cliente, antes de que Odoo haya aplicado el evento.

Lo que hace Odoo con el conector

Con el evento replaced:

1. Toma el mandato nuevo de links.new_mandate.
2. Pasa a ese mandato el método de pago guardado del cliente y lo da por bueno, en vez de darlo por perdido. Si el método estaba archivado, lo reactiva; Odoo 17 no deja desarchivar un método de pago, y ahí el conector crea uno nuevo para el mandato nuevo.
3. Lo escribe en la ficha del cliente: «El mandato de GoCardless se puede volver a usar (replaced).».

Esa nota la escribe el conector al aplicar el evento, sin nadie delante. En una base de datos creada en castellano sale así; en una creada en inglés y pasada después a castellano, en inglés: «The GoCardless mandate is usable again (replaced).».

Con mandate_replaced en un cobro, el conector no hace nada especial: al crear un cobro solo trata aparte mandate_is_inactive. La transacción pasa a «Error» con «GoCardless rechazó la solicitud.» y, debajo, el mensaje de GoCardless con mandate_replaced y el request_id entre corchetes. El mandato nuevo lo toma del evento, no del error. Ese mensaje sale en el idioma de quien lanza el cobro; si lo lanza una tarea programada, en una base creada en inglés y pasada después a castellano sale en inglés: «GoCardless rejected the request.».

Qué hacer

1. Si un cobro se queda en error con mandate_replaced, abre la transacción desde la factura, con el botón «Transacción de pago» de arriba; el menú de transacciones solo sale en modo desarrollador, y en Odoo 20 no existe.
2. Mira en la ficha del cliente si ya está la nota de que el mandato se puede volver a usar (replaced). Si está, el método de pago ya apunta al mandato nuevo.
3. Si no está, el evento aún no ha llegado. La tarea que cada hora recupera los eventos perdidos lo trae; si tarda más de eso, revisa que los webhooks de GoCardless lleguen a Odoo.
4. Con el método de pago al día, vuelve a cobrar la factura.

Con nuestro conector

En Odoo 17, 18, 19 y 20 el conector sigue al mandato nuevo en cuanto GoCardless avisa de la sustitución: el cliente conserva su método de pago y la siguiente factura se cobra con el mandato que GoCardless dejó en su lugar.

Sigue leyendo