Saltar al contenido principal

Integración para Comercios

Como comercio en Pago46, accedes a una red híbrida de puntos físicos donde tus usuarios pueden pagar o recibir efectivo. Tú gestionas todo digitalmente mediante nuestra API.

Servicios disponibles​

Pay-In (Cobros)​

Permite que tus usuarios paguen con efectivo en cualquier punto de la red.

Casos de uso: Recargas de billeteras, suscripciones, e-commerce, servicios.

Ver documentación de Pay-In

Pay-Out (Dispersiones)​

Permite que tus usuarios retiren efectivo o reciban pagos en puntos físicos.

Casos de uso: Retiros de saldo, pagos a trabajadores, remesas, reembolsos.

Ver documentación de Pay-Out

Moneda extranjera​

Operaciones con conversión de divisas.

Ver documentación de Moneda extranjera

Checkout​

Integra la aplicación web de Checkout en un iframe para flujos Pay-In y Pay-Out.

Ver documentación de Checkout

Checkout de Pago46

Las órdenes contienen el campo redirect_url, que corresponde al enlace de Checkout para que tu usuario continúe el flujo.

  • Sandbox: https://checkout.dev.pago46.io
  • Producción: https://checkout.prd.pago46.io
  • Formato por orden: https://checkout.{dev|prd}.pago46.io/{UUID}

También puedes entrar a la página principal de Checkout (sin UUID) para ingresar manualmente el identificador de la orden durante las pruebas de integración en un iframe.

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 Merchant-Key y Merchant-Secret
  2. Implementa autenticación HMAC - Ver guía
  3. Crea órdenes - Usa POST /merchants/orders/pay-in o /pay-out
  4. Recibe webhooks - Configura tu endpoint HTTPS para notificaciones
Requisito fundamental

Todas las peticiones requieren autenticación HMAC. Revisa la documentación de autenticación antes de comenzar.

Ambientes​

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

→ Ver detalles de ambientes

Ciclo de vida de las órdenes​

Como comercio, tu integración reacciona a los estados finales de la orden (COMPLETED, CANCELLED, EXPIRED), que reportamos vía webhooks. El procesamiento intermedio (cuando un proveedor toma la orden y cobra o entrega el efectivo) se resuelve de forma interna y no requiere acción de tu parte.

Notificaciones de órdenes en moneda extranjera

Los comercios reciben webhooks cuando una orden alcanza un estado final. En Pay-Out en moneda extranjera, también recibirás dos notificaciones previas: una actualización CREATED que agrega la transacción que debes firmar, y un webhook READY cuando confirmamos que los fondos on-chain llegaron a Pago46 y la orden está lista para dispersarse en efectivo al usuario final.

¿Quién puede cancelar?

Los comercios no pueden cancelar órdenes. En Pay-In la cancelación la realiza el usuario final o el equipo de Pago46; en Pay-Out (moneda local y extranjera) solo el equipo de Pago46 puede cancelar. Preferimos que las órdenes no atendidas expiren de forma natural.

Recibirás una notificación HTTP POST en tu notify_url cuando la orden alcance un estado final. El flujo de Pay-Out en moneda extranjera también envía las notificaciones CREATED y READY descritas arriba, por lo que en ese flujo puedes recibir más de una notificación con el mismo status.

Cobertura​

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