Flujo de Pago con APM
Siga los métodos de pago alternativos a partir de la acción del cliente o la confirmación del proveedor, ya sea con éxito, denegación, cancelación o expiración.
En esta página
Los métodos de pago alternativos (APM) pueden requerir una redirección, un cambio de aplicación, un código QR, un cupón, la aprobación del banco o la confirmación tardía del proveedor. Consulte el valor actual de payment.data.statussi el pago está dentro de una respuesta de pedido, lea order.payment.data.status.
Utilice esta página para la ruta específica del APM. Para cada definición de estado y transición directa permitida, consulte Flujo y estados de pago.
Flujo APM estándar#
La mayoría de los APM comienzan con pending. Algunos confirman inmediatamente; otros permanecen pendientes mientras el cliente actúa, luego exponen processing mientras DEUNA espera la confirmación del proveedor.
| Estado | Significado | Acción del comerciante |
|---|---|---|
pending | La acción del cliente, la enrutamiento o la confirmación del proveedor aún no están completadas. | Presente next_action o las instrucciones del método y mantenga la ejecución bloqueada. |
processing | El método está esperando un resultado del proveedor de forma asíncrona. | Espera o recupera el pago definitivo; no intente de nuevo prematuramente. |
processed | El pago APM se ha completado. | Aplique la política de ejecución y conserve las referencias del proveedor. |
denied | El intento actual fue infructuoso. | No ejecute; conserve la razón y evalúe si se permite un nuevo intento. |
cancelled | El método o comerciante canceló el pago. | Verifique si los fondos anteriores requieren un reembolso o anulación antes de cerrar el pedido. |
expired | La ventana de finalización permitida ha expirado. | Registre la finalización del terminal y cree un nuevo pago para un nuevo intento del cliente. |
URLs de acción del cliente y de retorno#
Siga las next_action proporcionadas por DEUNA. Un retorno del navegador, un retorno de la aplicación o una página de éxito visible para el cliente no prueban que el dinero se haya movido. Confirme payment.data.status después de que DEUNA reciba y procese el resultado del proveedor.
Si el cliente abandona la redirección o cierra el navegador, mantenga el pago sin resolver hasta que DEUNA informe del resultado. No derive denied, cancelledo expired del comportamiento de la interfaz.
Ventanas de finalización#
El tiempo permitido para completar un pago es específico del método y la configuración. La expiración del cupón, la validez del código QR, los tiempos de espera de la sesión bancaria y las ventanas de procesamiento del proveedor no son intercambiables.
No calcule el estado final del pago a partir del tiempo del navegador o un temporizador local. Mantenga la ejecución bloqueada y espere hasta que DEUNA informe processed, denied, cancelledo expired. Si su experiencia para el cliente muestra un contador, trátelo como una guía de presentación, a menos que el contrato del método lo haga explícitamente.
APM con autorización#
Algunas conexiones APM admiten la autorización y la captura. Estos métodos pueden exponer authorizing, authorized, capturing, capturedo estados de captura parcial en lugar de la ruta estándar de compra.
Cuando un APM utiliza la autorización, siga las guía de flujo de captura y anulación de tarjetas para los estados de pago compartidos, pero confirme el soporte del método y del procesador con su Administrador Técnico de DEUNA (TAM). No infiera el soporte de captura o anulación a partir de la presencia de un estado en la máquina de estado global.
Cancelación y reembolsos#
cancelled no necesariamente es el último estado financiero. Si se han recolectado fondos, el pago puede continuar refunded; si existió una autorización, puede continuar voided.
Después de un pago exitoso processed los reembolsos pueden pasar a través partial_refunding, partial_refunded, refundingy refunded cuando la conexión APM lo admite. Consulte MPR: Reembolsos parciales múltiples para los modos admitidos, límites de tiempo, concurrencia y comportamiento del saldo restante.
Lista de verificación de integración#
- Mantenga la ejecución bloqueada mientras el pago está
pendingoprocessing. - Sigue la acción siguiente sin considerar la devolución del cliente como confirmación de pago.
- Guarda las referencias del proveedor y los montos confirmados con cada actualización.
- Maneja de forma idempotente las notificaciones tardías y repetidas del proveedor.
- Obtén el pago autorizado después de un tiempo de espera del cliente o la ausencia de devolución.
- Usa la referencia de transición validada Para los casos de reintentos, reembolsos y conciliaciones que no se muestran en el flujo normal.