GoCardless 429 rate_limit_exceeded: demasiadas peticiones por minuto

Qué dice GoCardless

La página de límites de GoCardless pone la cifra: 1.600 peticiones por minuto en una integración estándar y 1.600 por minuto y comercio en una integración de partner. Al pasarse, la API devuelve el 429, y GoCardless aclara que esas peticiones se pueden repetir sin problema: «These requests are safe to retry.». Para saber cuándo, remite a las cabeceras de la respuesta: ratelimit-limit, ratelimit-remaining y ratelimit-reset.

De dónde salen tantas peticiones

El límite cuenta todas las peticiones a la API, no solo las que crean cobros. Con el conector, cada cobro con un mandato guardado es una petición, venga de una suscripción que se renueva o de un pago registrado con el método de pago del cliente. Cada evento de un pago que llega a Odoo es otra, porque el conector no se fía solo del aviso: pide ese pago a GoCardless y aplica el estado que le devuelve. Una tanda grande en el mismo momento, como muchas renovaciones a la vez mientras llegan los eventos de los cobros anteriores, suma las dos cosas.

GoCardless clasifica este reason entre los errores invalid_api_usage, los que vienen de cómo se hace la petición, y para esos pide avisar al equipo técnico («alert your dev team»). Un 429 suelto no lo necesita; uno que se repite cada día, sí.

Lo que hace el conector

1. Lee la cabecera ratelimit-reset y calcula cuánto falta: la hora que trae menos la del servidor de Odoo.
2. Espera ese tiempo, como mínimo 1 segundo y como mucho 65. Si la cabecera falta o no se puede leer, espera 1 segundo. El tope está para que un reloj mal puesto no deje colgado el proceso de Odoo que espera.
3. Repite la petición una sola vez.
4. Si la repetición vuelve a recibir un 429, ya no espera más: lo trata como cualquier otro rechazo de la API.

El conector no cuenta sus peticiones ni las frena por adelantado. No lee ratelimit-remaining: solo espera cuando GoCardless ya ha contestado 429.

Si el segundo intento también choca

Depende de lo que estaba haciendo Odoo en ese momento.

• Si era un cobro, la transacción pasa a «Error» con «GoCardless rechazó la solicitud.» y, debajo, el mensaje de GoCardless con rate_limit_exceeded y el request_id entre corchetes. La factura sigue pendiente de cobro.
• Si estaba aplicando un evento de GoCardless, el webhook contesta 500 para que GoCardless vuelva a mandar el envío, y los eventos que ya se aplicaron no se aplican dos veces. La recuperación de cada hora tampoco deja atrás un evento que falló: lo vuelve a pedir en la pasada siguiente.

Un 429 no es lo mismo que un cobro sin respuesta. Sin respuesta, el conector no sabe si GoCardless creó el cobro, así que lo deja pendiente y lo vuelve a mandar, con la misma clave, en menos de una hora. Con un 429 sí hay respuesta: GoCardless no aceptó la petición, y por eso la transacción queda en error.

Ese mensaje sale en el idioma de quien lanza el cobro. Si lo lanza una tarea programada, como la renovación de una suscripción, 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 rejected the request.».

Qué hacer

• 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. Si el mensaje nombra rate_limit_exceeded, GoCardless rechazó esa petición por el límite, no por el cliente ni por su mandato.
• Pasado un rato, vuelve a cobrar la factura con el método de pago guardado del cliente.
• Si te pasa a menudo, comprueba la hora del servidor de Odoo: la espera sale de restarla a la de ratelimit-reset, y un reloj adelantado la acorta.
• Si necesitas a GoCardless, guarda el request_id del mensaje: su documentación pide incluirlo al contactar con su soporte.

Con nuestro conector

En Odoo 17, 18, 19 y 20 el conector trata el 429 como una pausa: espera lo que pide GoCardless, repite una vez y, si el límite sigue, deja la transacción en error con el request_id para que sepas qué pasó y qué darle a GoCardless.

Sigue leyendo