Revolut actualizó respuesta de su API a las devoluciones rechazadas con Revolut Pay.
Revolut actualizó respuesta de su API a las devoluciones rechazadas con Revolut Pay.

Revolut Pay actualiza su API de devoluciones: el error que deben evitar las tiendas

Revolut ha actualizado la respuesta de su API a las devoluciones rechazadas con Revolut Pay. El cambio afecta a tiendas que automatizan reembolsos: un código 200 ya no basta para dar el dinero por devuelto ni cerrar la incidencia con el cliente.

Publicado Actualizado
Ver LinkedIn del autor
Seguir en

Un código 200 puede acompañar a una devolución rechazada

El 16 de noviembre de 2026, Revolut anunció la disponibilidad de la versión 2026-09-22 de su API para comercios. La novedad está en la operación Refund an order: cuando una devolución de Revolut Pay se rechaza o falla, la plataforma puede responder con HTTP 200 y devolver los datos de la orden, en lugar del 400 que recibían las integraciones anteriores. Eso no significa que el dinero se haya devuelto.

La diferencia está dentro de la respuesta. En payments[], el campo state puede indicar declined o failed, mientras que decline_reason muestra la causa. Revolut menciona, entre otros motivos, una sospecha de fraude o un error técnico. Su ejemplo muestra incluso una orden en estado processing con el pago asociado rechazado. Mirar solo el código HTTP, por tanto, puede llevar a una conclusión equivocada.

No se aplica igual a todos los pagos. Las devoluciones rechazadas de tarjetas, incluidas las carteras digitales, siguen devolviendo 400, sin detallar la causa en esa respuesta. Para conocerla, hay que recuperar la orden de reembolso y consultar sus datos. Y las versiones anteriores a 2026-09-22 mantienen, según Revolut, su comportamiento actual.

Noticia relacionada Revolut Pay permite pagar desde una cuenta Business: qué deben revisar las empresas españolas Banca para empresas y autónomos

Qué tiendas deben revisar su integración y desde cuándo

El cambio interesa a los comercios que cobran con Revolut Pay y tramitan devoluciones mediante la Merchant API con versión 2026-09-22. Puede afectar a tiendas online de autónomos y pequeñas empresas en España con una integración propia. No es una modificación para todos los titulares de Revolut ni para cualquier negocio que tenga un datáfono.

La versión se selecciona indicando Revolut-Api-Version: 2026-09-22 en la cabecera de las peticiones correspondientes. El número de versión no es una fecha límite para adaptar la tienda. Revolut publicó su aviso el 16 de noviembre y señala que las versiones anteriores siguen operativas. Lo que hay que revisar es qué comportamiento espera el programa cuando el negocio decida adoptar la nueva versión.

Quien venda mediante un módulo de comercio electrónico o un proveedor externo no debería asumir que la actualización ya le afecta. Conviene confirmar qué versión utiliza realmente esa integración y quién interpreta los estados de devolución. El punto delicado está en conectar la respuesta de Revolut con el correo al comprador, el estado del pedido y los asientos de la contabilidad.

Noticia relacionada Unicaja lanza una cuenta remunerada para pymes: qué condiciones hay que mirar Banca para empresas y autónomos

El impacto real: clientes, liquidez y una comisión que no vuelve

Si una tienda marca cualquier respuesta 200 como «reembolso realizado», podría enviar al cliente una confirmación equivocada, cerrar una devolución pendiente o registrar una salida de dinero que no se ha producido. No es una pérdida automática para el negocio, pero sí un desajuste que consume tiempo y puede complicar la relación con quien espera recuperar su dinero.

Además, una devolución no termina necesariamente cuando la API responde. Revolut explica que el proceso es asíncrono y puede tardar hasta dos días en alcanzar un estado final. Recomienda seguir cada orden mediante avisos automáticos, conocidos como webhooks, o consultando su estado. Entre las causas documentadas de rechazo figura incluso la falta de saldo suficiente en la cuenta Revolut Business del comercio: ahí la liquidez también importa.

En cuanto al coste, Revolut aclara en su ayuda para España que emitir un reembolso desde una cuenta Comercio no tiene comisión adicional, pero no devuelve la comisión cobrada por el pago original. La nueva API no se anuncia como un cambio de tarifas. Para un negocio que compara lo que realmente le cuesta cobrar y devolver, la guía de mejores TPV aporta contexto sobre comisiones, liquidaciones y condiciones.

Noticia relacionada Revolut Business cambia sus condiciones el 30 de noviembre: la cláusula de 5.000 dólares Banca para empresas y autónomos

Qué comprobar antes de dar una devolución por cerrada

La primera comprobación es técnica, pero el efecto se nota en el mostrador: no confundir una respuesta 2xx con dinero reembolsado. La integración debe revisar payments[].state y payments[].decline_reason, guardar el identificador de la nueva orden de devolución y distinguir entre solicitud recibida, rechazo y operación completada. También debe probar qué mensajes manda al cliente en cada caso.

Con las tarjetas hay otra precaución. Revolut advierte de que una respuesta 400 por devolución rechazada puede ir acompañada de una orden de reembolso creada. Antes de repetir la petición, hay que localizar esa orden y comprobar el motivo del fallo. La documentación contempla la cabecera Idempotency-Key para prevenir procesamientos duplicados cuando se reenvía una solicitud. Y, si hay devoluciones parciales, debe verificarse cuánto importe queda por devolver.

Para el autónomo o la pequeña empresa, la revisión debería acabar con una respuesta concreta de su proveedor tecnológico: qué versión está activa, cómo se tratan los rechazos y cuándo se informa al comprador. Separar la cuenta bancaria del sistema de cobros también ayuda a no mezclar decisiones; la comparativa de mejores bancos para empresas permite valorar la operativa general, pero no sustituye la prueba de una devolución. Primero hay que confirmar su estado real; después, darla por cerrada.