Saltar al contenido principal

Integración para Proveedores de Pago

Como Proveedor de Pago, integras tu red de puntos físicos (tiendas, kioscos, agentes) a Pago46 para procesar cobros y dispersiones de efectivo generados por comercios.

Servicios disponibles​

Pay-In (Cobros)​

Procesa pagos en efectivo de usuarios finales en tus puntos físicos.

Flujo: El usuario presenta el código → validas y bloqueas la orden → recibes el efectivo → confirmas la transacción.

Ver documentación de Pay-In

Pay-Out (Dispersiones)​

Dispersa efectivo a usuarios finales en tus puntos físicos.

Flujo: El usuario presenta el código → validas y bloqueas la orden → entregas el efectivo → confirmas la transacción.

Ver documentación de Pay-Out

Flujo de integración​

La arquitectura es de servidor a servidor con autenticación HMAC SHA-256.

Pasos de integración​

  1. Obtén tus credenciales - Recibe tu Provider-Key y Provider-Secret
  2. Registra tus redes - Envíanos tu lista de redes/subredes para asignar network_id
  3. Implementa autenticación HMAC - Ver guía
  4. Consulta órdenes - Usa GET /providers/orders/{type}/{code}/
  5. Procesa transacciones - Usa start-payment y confirm-payment
Mecanismo de bloqueo

El bloqueo aplica tanto en Pay-In como en Pay-Out. Cuando llamas a start-payment, la orden queda reservada para tu red hasta confirmar o cancelar.

Redes y subredes

Para usar los endpoints, necesitas un network_id válido. Envíanos tu lista de redes/subredes para que podamos registrarlas y asignar los IDs.

Ambientes​

AmbienteURLUso
Sandboxapi.dev.pago46.ioDesarrollo y pruebas
Producciónapi.prd.pago46.ioOperaciones reales

→ Ver detalles de ambientes

Monitoreo operativo

Para operación diaria en caja/soporte, consulta la página de Estado del Servicio y suscríbete a alertas por correo o Slack para enterarte de incidentes y mantenimientos.

Ciclo de vida de las órdenes​

El diagrama de estados es el mismo para Pay-In y Pay-Out. Cada flecha indica la acción que dispara la transición: las que llevan nombre de endpoint (start-payment, confirm-payment, cancel-payment) son las que tú, como proveedor, invocas vía API; el resto ocurre de forma automática o lo dispara el comercio.

¿Desde qué estado puedo actuar?

La acción permitida depende del estado actual de la orden:

  • Tomar una orden → start-payment, disponible solo desde READY.
  • Liberar / "devolver" una orden → cancel-payment, disponible solo desde PAYMENT_STARTED, antes de confirmar y únicamente para el proveedor que bloqueó la orden. La orden vuelve a READY y queda disponible de nuevo. Si otro proveedor la bloqueó, no puedes actuar sobre ella.
  • Confirmar la transacción → confirm-payment, disponible solo desde PAYMENT_STARTED. La orden pasa a COMPLETED. Confirma únicamente cuando el efectivo ya cambió de manos: en Pay-In cuando recibiste el dinero, en Pay-Out cuando lo entregaste.
  • Los estados COMPLETED, CANCELLED y EXPIRED son finales: no admiten más transiciones.
No hay reversas vía API

Es una operación en efectivo y la confirmación es inmediata: una orden en COMPLETED no se puede devolver ni revertir desde la API. Cualquier ajuste posterior se resuelve en la operación de liquidación (settlement) acordada con el equipo de Pago46. Por eso confirm-payment debe reflejar siempre un movimiento real de efectivo.

¿Quién puede cancelar una orden?

Como proveedor nunca llevas una orden a CANCELLED: cancel-payment solo la libera de vuelta a READY. La cancelación definitiva la dispara:

  • En Pay-In: el usuario final o el equipo de Pago46.
  • En Pay-Out: solo el equipo de Pago46.

Los comercios no pueden cancelar órdenes.

Cobertura​

Pago46 opera en múltiples países de Latinoamérica. Ver lista completa.