Efectivo
Crear un pago en efectivo en Ecuador consiste en capturar los datos necesarios del cliente para el pago y hacer una solicitud a través de nuestra API con un Bearer Token y una secretKey. De esta forma, las transacciones se autentican y se realizan de forma segura.
Conoce los puntos físicos de pago disponibles en este artículo.
¿Cómo funciona?
Red Activa / Western Union, BeMovil y PonleMás son redes y plataformas que operan en Ecuador y permiten realizar pagos en efectivo para servicios, recargas y otras transacciones. Para completar una transacción con cualquiera de estos métodos, el usuario debe seleccionar la opción correspondiente:
- Paga con Efectivo - Western Union | Red Activa
- Paga con Efectivo - BeMovil
- Paga con Efectivo - PonleMás
Luego, debe acudir al punto de atención más cercano con su código de pago y una identificación válida (cédula nacional, cédula de extranjería o pasaporte).
El proceso de pago con efectivo en Ecuador consta de seis etapas principales:

- Ingreso de datos. Después de seleccionar los productos o servicios a comprar, el cliente ingresa sus datos personales en un formulario.
- Selección de método. El cliente elige pagar con efectivo en tu sitio web o aplicación.
- Hoja de pago. ProntoPaga le entrega una hoja de pago personalizada al cliente, con un código de pago único, así como la información de los puntos físicos en donde puede realizar el pago.
- Pago en punto físico. El cliente se dirige a uno de los puntos físicos con su hoja de pago y su identificación, y hace el depósito del efectivo.
- Validación de datos. ProntoPaga valida la infomación del pago.
- Confirmación. El cliente recibe una confirmación de pago exitoso en su correo electrónico. A su vez, tu comercio recibe la confirmación del pago a través de los webhooks que hayas configurado.
Crea un nuevo pago
Tu front-end será el encargado de recopilar los datos necesarios de tu cliente para procesar el pago, mientras que tu back-end estará integrado con nuestra API, procesando el pago.
De este modo, para crear una solicitud de nuevo pago deberás usar este endpoint y colocar el método de pago en efectivo en el body de la solicitud.
La solicitud se envía con tu Bearer Token, así como con tu secretKey. Además, debes incluir los datos necesarios del cliente para hacer el pago, como: nombre, correo electrónico, teléfono, país, moneda, monto, entre otros.
Firma de la transacciónPuedes ver el detalle de cómo firmar los parámetros de la transacción con tu secretKey en este artículo.
También deberás incluir la URL de retorno en caso de que la transacción sea exitosa, así como una URL en caso de que el pago sea rechazado.
Notificación del estado de la transacciónPara configurar el webhook que irá en el campo
confirmationURL
y recibir notificaciones con el estado de tu transacción, revisa este artículo.
Body de la solicitud
A continuación puedes ver un ejemplo del body que se envía en la solicitud:
{
"currency": "USD",
"country": "EC",
"amount": "25.90",
"clientName": "John Doe",
"clientEmail": "[email protected]",
"clientPhone": "0912345678",
"clientDocument": "12345678912",
"paymentMethod": "bemovil_payment",
"urlConfirmation": "https://www.webhook.com",
"urlFinal": "https://sandbox.prontopaga.com/successful",
"urlRejected": "https://sandbox.prontopaga.com/declined",
"order": "XYZ789",
"sign": "Signature of the parameters"
}
Respuesta
Como respuesta a una solicitud de pago exitosa, recibirás un enlace con la hoja de pago, así como un identificador de pago del sistema.
Hoja de pago
El cliente verá en pantalla y recibirá en su correo electrónico la hoja de pago, que contendrá:
- Monto a pagar
- Código de pago
- Instituciones en las que puede hacer el pago
- Instrucciones para hacer el pago
Confirmación de un pago
Una vez que el usuario haya realizado el pago en efectivo, ProntoPaga le notificará el resultado final de su transacción. Al mismo tiempo, devolverá los datos de la transacción a la URL que especificaste en urlConfirmation
.
Para confirmar si una transacción fue exitosa, debes verificar que en tu webhook el valor del campo status
sea success
.
Conoce todos los estados posibles de un pago en el siguiente enlace: Estados de los pay ins.
Prueba tu integración
Contamos con un catálogo de datos de prueba que puedes usar para comprobar que tu integración está lista, así como para ver el flujo de pago que seguirá tu cliente. Además, puedes hacer pruebas con nuestros demos:
Certifica tu integración
La certificación de la integración en sandbox es un paso obligatorio que todos los comercios deben realizar antes de recibir sus credenciales de producción. Su propósito es asegurar que la integración cumpla con los estándares técnicos, funcionales y de seguridad requeridos por ProntoPaga. Dentro de esta sección, se establecen los requisitos que deben cumplirse sin excepción para que la certificación sea aprobada.
Requisitos de certificación
A continuación, encontrarás los distintos requisitos necesarios para completar tu certificación:
- ❌ El documento de identidad del cliente no debe ser modificable en ningún punto de la transacción.
- ✅ Es recomendable que este dato no se muestre en el checkout. Solo puede estar disponible en la sección de perfil del usuario autenticado.
- ⚠️ Esta medida tiene como objetivo prevenir fraudes y evitar que se realicen transacciones en nombre de terceros o menores de edad.
Updated about 13 hours ago