meta para todos los APIs de Devolución son los siguientes:
| Código | Descripción |
|---|---|
00 | Se procesó correctamente la petición |
01 | Algunas operaciones fueron rechazadas |
03 | Ocurrió un error |
05 | No se encontró el pedido |
06 | Algunos datos no fueron enviados correctamente |
Cómo interpretarlos
Éxito total
Usa
00 cuando la petición fue procesada correctamente a nivel del flujo.Éxito parcial
Usa
01 cuando el request fue aceptado, pero una o más operaciones fueron rechazadas dentro del lote.Error funcional
Usa
05 y 06 para errores de negocio o datos incompletos que deben corregirse antes de reintentar.Error general
Usa
03 para fallas no controladas o errores de procesamiento del flujo.Consejos de integración
No dependas solo de meta.status.code
No dependas solo de meta.status.code
Aunque
meta.status.code resume el resultado del request, también debes revisar operations[].state y operations[].refund_reason para conocer el resultado real de cada devolución.Distingue registro de resolución
Distingue registro de resolución
Que una devolución quede en
REGISTERED no significa que ya terminó. Usa las APIs de consulta para seguir su avance hasta RESOLVED o REJECTED.Maneja lotes parcialmente rechazados
Maneja lotes parcialmente rechazados
Cuando recibas
01, procesa el detalle por operación. No asumas que todo el batch falló ni que todo el batch fue aceptado.Conserva identificadores
Conserva identificadores
Guarda
refund_id, merchant_operation_number y transaction_id para conciliación, soporte y reprocesos.Valida montos y estado origen
Valida montos y estado origen
Antes de solicitar una devolución, confirma que la transacción original esté en
LIQUIDADO y que el monto cumpla con tus reglas internas para devoluciones totales o parciales.Recomendación operativa
Para integraciones backend, lo más seguro es tratar
POST /refund como una solicitud inicial y luego confirmar el estado definitivo con la consulta unitaria o masiva cuando tu flujo necesite conciliación o seguimiento.