Skip to main content
Pay-me ofrece a los comercios la funcionalidad de Devoluciones, permitiendo automatizar la gestión de devoluciones por medio de APIs especializadas. Las capacidades contempladas en este módulo son:
  • API de Devoluciones
  • API de Consulta Unitaria de Devolución
  • API de Consulta Masiva de Devolución
  • Códigos de Respuesta - Devoluciones

​
Momento del ciclo

Extorno

Se aplica sobre transacciones AUTORIZADO, antes de la liquidación.

Devolución

Se aplica después de la autorización, únicamente sobre transacciones en estado LIQUIDADO.
La devolución no reemplaza al extorno. Operativamente corresponde a una etapa posterior del ciclo de vida del pago.

​
APIs del módulo

API de Devoluciones

Permite registrar una o más solicitudes de devolución total o parcial para transacciones liquidadas.

API de Consulta Unitaria de Devolución

Permite revisar el detalle y lifecycle de una solicitud específica de devolución.

API de Consulta Masiva de Devolución

Permite consultar múltiples solicitudes de devolución para control operativo y conciliación.

Códigos de Respuesta - Devoluciones

Resume los códigos funcionales y mensajes que debes interpretar en las respuestas del módulo.

​
Métodos de pago soportados

CARD

Tarjetas de crédito y débito liquidadas.

YAPE

Operaciones liquidadas procesadas con Yape.

CUOTEALO

Operaciones liquidadas procesadas con Cuotéalo.

​
Reglas base

La devolución solo se efectúa sobre transacciones en estado LIQUIDADO.
Puedes enviar una o más operaciones en un mismo request.
El tipo de devolución soportado es TOTAL o PARTIAL.
Conserva merchant_operation_number y transaction_id para trazabilidad y conciliación.

​
Consejos de integración

No cierres el caso solo con REGISTERED

Toma REGISTERED como recepción de la solicitud. Usa las APIs de consulta para confirmar si la devolución avanza a RESOLVED o termina en REJECTED.

Maneja parciales y lotes

Si integras devoluciones parciales o varias operaciones en un mismo request, revisa cada resultado individual y no solo el código global del meta.

Valida elegibilidad antes de enviar

Verifica que la transacción origen esté en LIQUIDADO, que el método sea soportado y que el monto a devolver cumpla tus reglas internas.

Guarda identificadores

Conserva refund_id, merchant_operation_number y transaction_id para conciliación, auditoría y soporte.

​
Siguiente paso

API de Devoluciones

Revisa el endpoint POST /refund, la estructura del request, la respuesta y el ejemplo base del flujo.