Flujo de Pago

Las APIs de pago devuelven resultados de solicitud en result_code y resultados de negocio en biz_response.result_code. HTTP 200 no significa que el pago fue exitoso. Todas las solicitudes de pago se inician desde una identidad de terminal del cliente activada.

Terminal del clienteMUWE OpenAPIProveedor de pagoConsumidor

1

La terminal envia pay, pre-create u orden enviada firmada con `terminal_sn`.

2

MUWE valida credenciales de terminal, alcance del comercio, idempotencia y ruta de proveedor.

3

El proveedor maneja la autorizacion o devuelve el payload de pago del consumidor.

4

El consumidor completa el pago en el canal configurado o en la terminal POS vinculada.

5

MUWE devuelve estado de negocio exitoso, fallido o en progreso.

6

Si el resultado es incierto, consulta antes de entregar, cancelar, reembolsar o reintentar.

Pago iniciado por el comercio

Terminal del clienteCrea la orden y llama `POST /upay/v2/pay` con un `client_sn` unico.

MUWE OpenAPIValida la firma de terminal, enruta la solicitud y devuelve resultado de negocio.

Proveedor / consumidorCompleta el pago o deja la orden en progreso.

1. El cajero, POS o MIS del comercio inicia la solicitud de pago desde una terminal del cliente activada.
2. El cliente llama POST /upay/v2/pay con un client_sn unico.
3. Si biz_response.result_code es PAY_SUCCESS, entrega bienes.
4. Si es PAY_IN_PROGRESS, o hay error de red despues de que la solicitud pudo llegar a MUWE, consulta por client_sn.
5. Si la orden no llega a estado final dentro del tiempo limite del comercio, llama POST /upay/v2/cancel.
6. Nunca reutilices el mismo client_sn para un nuevo intento despues de un pago fallido o incierto.

Envio de orden MIS a POS

MIS del comercioCrea una orden para una terminal POS vinculada.

Terminal POS vinculadaRecibe la orden y conduce el flujo de pago con el consumidor.

MUWE / proveedorProcesa el pago y expone el resultado final por notificacion o consulta.

1. El MIS o caja del comercio crea una orden para una terminal POS vinculada.
2. El POS recibe la orden y conduce el flujo de pago con el consumidor.
3. MUWE procesa el pago con el proveedor configurado.
4. El cliente recibe notificacion o consulta POST /upay/v2/query hasta llegar a un estado final.

Pre-creacion QR

Terminal del clienteLlama `POST /upay/v2/precreate` para una orden del comercio.

MUWE OpenAPIDevuelve `qr_code` o payload de pago del proveedor.

App del consumidorEscanea o abre el payload de pago y completa el pago.

1. El cliente llama POST /upay/v2/precreate.
2. MUWE devuelve qr_code o payload de pago del proveedor.
3. El comercio muestra el codigo QR o URL de pago.
4. El cliente final completa el pago en la app del proveedor.
5. El cliente espera notificacion o consulta POST /upay/v2/query.

Reembolso

Los reembolsos son idempotentes por refund_request_no.

1. Consulta la orden y confirma que se puede reembolsar.
2. Llama POST /upay/v2/refund con sn o client_sn y un refund_request_no unico.
3. Si el resultado del reembolso es incierto, consulta usando la identidad de la orden original y refund_request_no.
4. No envies un reembolso de reemplazo con un nuevo refund_request_no hasta que el primero sea final.

Recuperacion por cancelacion

cancel es para ordenes no pagadas o inciertas. Usalo cuando el cliente no puede probar que el pago fallo pero necesita prevenir un exito posterior.

Si cancel devuelve CANCEL_SUCCESS, la orden queda cerrada. Si devuelve CANCEL_ERROR, CANCEL_ABORT_ERROR o hay timeout de red, sigue consultando y escala si la orden no llega a estado final.

Reversa

revoke no es la misma operacion que cancel. Usa POST /upay/v2/revoke solo para reversa del mismo dia de una orden pagada cuando la ruta del proveedor lo soporta explicitamente.

Estados finales

Estado	Significado
PAID	Pago completado.
PAY_CANCELED	Pago fallido y cancelado.
REFUNDED	Reembolso total.
PARTIAL_REFUNDED	Reembolso parcial.
CANCELED	Orden cancelada antes de completar el pago.

Estados intermedios como CREATED, IN_PROG, ERROR_RECOVERY y PRE_SUCCESS no son finales. Consulta hasta recibir un estado final o requerir intervencion de soporte.