GoCardless mandate_not_inactive: el mandato no se puede reactivar

Qué dice GoCardless

GoCardless separa las dos partes del texto con una raya. En la referencia de la API lo detalla: «This will fail with a mandate_not_inactive error if the mandate is already being submitted, or is active.». Es un error invalid_state, y para esos GoCardless pide avisar al usuario y no reintentar («invalid_state → inform the end user, do not allow retry.»).

Qué mandatos se pueden reactivar

La reactivación tiene más condiciones que el estado:

• Es una función restringida: «Restricted this endpoint requires approved custom payment pages».
• Solo vale para un mandato cancelado desde el Dashboard o la API: «A mandate can only be reinstated if it has been cancelled through the dashboard or the API.». Uno que canceló el banco, no: «Any mandate that has been cancelled by the bank cannot be reinstated.».
• Sirve para mandatos cancelados o caducados («Reinstates a cancelled or expired mandate to the banks.»), y un mandato se puede volver a presentar hasta 10 veces («Mandates can be resubmitted up to 10 times.»).

Después de pedirla, el proceso es el de un alta: llega resubmission_requested y luego, como dice GoCardless, «so you will receive a submitted webhook, followed by a reinstated or failed webhook up to two working days later.».

Lo que hace Odoo con el conector

En la ficha del método de pago del cliente, el conector pone el botón «Reactivar mandato (sandbox)». Solo sale si el mandato es de GoCardless, el proveedor no está en producción (en Odoo 17, 18 y 19, el estado del proveedor; en Odoo 20, la casilla de producción) y «Estado del mandato» es cancelled, failed o expired.

Al pulsarlo:

1. El conector pide a GoCardless la reactivación de ese mandato.
2. Si GoCardless la acepta, el estado pasa a reinstate_requested y en la ficha del cliente queda «Se ha pedido reactivar el mandato de GoCardless. No se podrá usar hasta que el banco lo confirme.». El método de pago sigue archivado.
3. Cuando llega reinstated, el conector lo vuelve a dar por bueno: lo reactiva y escribe «El mandato de GoCardless se puede volver a usar (reinstated).».

Si GoCardless contesta mandate_not_inactive, el conector no lo captura: Odoo enseña «GoCardless rechazó la solicitud.» con el mensaje de GoCardless, el reason y el request_id, y el mandato se queda como estaba. Pasa cuando Odoo cree que el mandato está muerto y en GoCardless ya está activo o presentándose, porque sus eventos aún no han llegado a Odoo. Después de una petición aceptada, el botón ya no sale, porque el estado pasa a reinstate_requested.

La nota de que el mandato se puede volver a usar 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 (reinstated).».

Qué hacer

1. Si sale mandate_not_inactive, busca el mandato en el Dashboard de GoCardless. Si está activo o presentándose, no hay nada que reactivar: espera a que lleguen sus eventos. La tarea que cada hora recupera los eventos perdidos los trae.
2. Si el mandato lo canceló el banco, no lo intentes: GoCardless no reactiva esos. Pide al cliente un mandato nuevo.
3. En producción, el conector no ofrece la reactivación: el camino es un mandato nuevo firmado por el cliente.
4. Para probarlo, usa el sandbox de GoCardless con el proveedor en pruebas.

Con nuestro conector

En Odoo 17, 18, 19 y 20 el conector solo ofrece reactivar un mandato cancelado, fallido o caducado, y solo fuera de producción, y no lo vuelve a usar hasta que GoCardless confirma la reactivación con su evento.

Sigue leyendo