GoCardless 409 idempotent_creation_conflict: el cobro ya existía

Qué dice GoCardless

La página de límites de GoCardless lo completa: si ya existe un recurso con esa clave, la respuesta es un 409 con links.conflicting_resource_id, que señala el recurso que ya está creado. Las claves pueden tener hasta 128 caracteres y GoCardless las recuerda al menos 30 días.

El problema que resuelve

Una petición puede tardar: GoCardless corta las que pasan de 29 segundos, y la red puede cortarse antes. Si Odoo pide un cobro y no recibe respuesta, no sabe si GoCardless lo creó. Repetir la petición sin más es peligroso; la propia documentación de GoCardless avisa de que reintentar sin clave de idempotencia tras un tiempo de espera agotado puede cobrar el mismo pago dos veces.

Con clave, el segundo intento no crea nada: si el primero llegó, GoCardless contesta con este 409 y el identificador del cobro que ya existe.

Cómo lo usa el conector

El conector manda una clave de idempotencia en cada petición que crea un cobro, un reembolso, un reintento o la solicitud del mandato. La clave no es aleatoria. Se calcula con la operación, la transacción de Odoo y el identificador de la base de datos, de modo que:

• repetir el mismo cobro manda exactamente la misma clave;
• una copia de la base para pruebas no choca con la de producción aunque las dos emitan la misma factura.

Cuando llega el 409, el conector lee conflicting_resource_id, pide ese recurso a GoCardless y lo adopta como respuesta. Para ti no hay error: la transacción queda enlazada al cobro que ya existía, y la factura sigue su curso normal.

Cuando GoCardless no contesta

Si la petición se queda sin respuesta, el conector la repite una vez con la misma clave. Sin clave no repite nada. Si tampoco hay respuesta, avisa sin dar el cobro por perdido: «GoCardless no respondió, así que aún no se sabe si aceptó la solicitud. Se volverá a enviar, de forma segura, en menos de una hora.». La transacción queda pendiente, no en error, porque en error Odoo podría generar otro cobro con otra referencia y otra clave.

Ese aviso sale en el idioma de quien lanza el cobro. Si lo lanza una tarea programada, como la renovación de una suscripción o el reenvío del propio conector, se escribe sin nadie delante: en una base de datos creada en castellano sale así, y en una creada en inglés y pasada después a castellano, en inglés: «GoCardless did not answer, so it is not known yet whether it took the request. It will be sent again, safely, within the hour.».

Qué hacer

Con el conector, normalmente nada: el 409 se resuelve solo. Si lo ves en otro programa conectado a la misma cuenta de GoCardless, comprueba dos cosas. La primera, que no estés reutilizando una clave para operaciones distintas. La segunda, que el recurso de conflicting_resource_id sea el que esperabas: si lo es, el reintento ha funcionado como debe. Si no lo es, guarda el request_id de la respuesta: GoCardless pide incluirlo al contactar con su soporte, y el conector lo añade a sus mensajes de error.

Con nuestro conector

En Odoo 17, 18, 19 y 20 el conector aplica la regla que GoCardless pide para no cobrar dos veces: clave fija por operación, repetición solo con la misma clave y adopción del recurso existente cuando llega el 409.

Sigue leyendo