Acepta pagos con Deuna
Conoce el paso a paso de cómo crear un pago con wallet en Ecuador
Crear un pago a través de una wallet 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.
Disponible solo para comercios Low RiskDeuna está disponible solo para comercios low risk. Consulta si tu comercio cumple los requisitos con nuestro equipo de Customer Support.
¿Cómo funciona?
Deuna es una billetera digital utilizada en Ecuador que permiten realizar pagos en línea a través de sus aplicaciones. Para completar una transacción utilizando estos métodos de pago, el cliente debe seleccionar la opción "Paga con QR/Wallet - Deuna", tener una cuenta creada con saldo disponible o un medio de pago vinculado, y aprobar el pago desde la aplicación.
El proceso de pago con wallet en Ecuador consta de las siguientes etapas:
- Selección de método. El cliente elige pagar con wallet en tu sitio web o aplicación.
- Solicitud. ProntoPaga se comunica con la wallet y genera la solicitud de pago.
- Wallet. El cliente es redireccionado a la aplicación de su wallet.
- Captura. El cliente sigue los pasos en su aplicación de wallet y realiza el pago. El dinero se mueve desde la wallet del cliente hacia la cuenta de tu comercio.
- Confirmación. El cliente es redirigido a tu sitio y se muestra el resultado de la transacción. A su vez, tu comercio recibe la confirmación 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.
Body de la solicitud
Para crear una solicitud de nuevo pago deberás usar este endpoint y colocar deuna_payment como método de pago 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ónConoce a detalle cómo firmar los parámetros de la transacción con tu
secretKey.
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ónConsulta cómo configurar el webhook que irá en el campo
urlConfirmationy recibir notificaciones con el estado de tu transacción.
A continuación puedes ver un ejemplo del body que se envía en la solicitud:
{
"currency": "USD",
"country": "EC",
"amount": 10,
"clientName": "John Doe",
"clientEmail": "[email protected]",
"clientPhone": "999999999",
"clientDocument": "12345678912",
"paymentMethod": "deuna_payment",
"urlConfirmation": "https://www.webhook.com",
"urlFinal": "example.com/successful",
"urlRejected": "example.com/declined",
"order": "{{randomOrder}}",
"sign": "Signature of the parameters"
}Respuesta
Como respuesta a una solicitud de pago exitosa, recibirás un enlace para procesar el pago, así como un identificador de pago del sistema.
Ejemplo de respuesta para pago exitoso:
{
"uid": "01M70C7Y27DVAED0S5Q9W8RRPS",
"reference": "17942354306852",
"urlPay": "https://sandbox.prontopaga.com/payment/rest/01M70C7Y27DVAED0S5Q9W8RRPS"
}Ejemplo de respuesta de pago rechazado:
{
"error": {
"country": "country, value not valid."
}
}Pago en la wallet
El cliente podrá continuar el proceso siguiendo las instrucciones en pantalla. Deberá abrir la aplicación de su wallet para continuar con el pago.
Confirmación de un pago
Una vez que el usuario haya completado el proceso de pago en el formulario, ProntoPaga le mostrará una ventana con 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 PayIn.
Ejemplo de webhook para un pago exitoso:
{
"uid": "01KKHKJXR7QNVKNCW063HWFEAK",
"status": "success",
"amount": "10",
"method": "deuna_payment",
"reference": "17746887201540",
"clientEmail": "[email protected]",
"clientDocument": "1233701645",
"order": "9993338719",
"currency": "USD",
"country": "EC",
"method_type": "deuna_payment",
"method_detail": "1233701645",
"hash": "ee8b58d3e337740265d41d5a54e37ae8",
"sign": "f819c4c1130c37db7dd7c8ed3d2149e4bb2528a25fc42e11d50d036c287020ec"
}Tipos de rechazos
A continuación se muestran varios posibles casos de rechazo.
| Mensaje de rechazo |
|---|
| La transacción no se hizo desde la propia cuenta DeUna del cliente |
| Sin motivo registrado |
| Cliente bloqueado en DeUna |
| Documento de identidad no coincide con el registrado |
| Cancelada por el usuario |
| Excede límite de DeUna: 4 por monto máximo por transacción y 3 por límite mensual |
Límites transaccionales
Ten en cuenta que cada banco establece sus propios límites transaccionales. Estos límites pueden variar dependiendo del tipo de cuenta o sistema de autenticación del banco.
Consulta los límites transaccionales para el comercio, del procesador y de ProntoPaga en el siguiente artículo:
Prueba tu integración
Contamos con un demo que puedes usar para hacer pruebas y ver el flujo de pago que seguirá tu cliente:
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.
-
📥 Agregar los logotipos de los diferentes métodos de pago de ProntoPaga a tu front-end. Puedes descargarlos aquí.
-
🔎 Todos los nombres y logos de los métodos de pago habilitados deben mostrarse de forma clara, sin modificaciones visuales o estilísticas que puedan generar confusión o inducir a errores.
-
❌ Los logotipos de MACH y Banco BCI deben ser mostrados únicamente en el checkout.
-
✅ Se recomienda ordenarlos según su popularidad o frecuencia de uso, para mejorar la experiencia del usuario y optimizar la conversión.
- ✅ El checkout debe incluir mensajes claros y visibles que orienten al usuario durante todo el proceso.
❗ Es obligatorio mostrar:
- ℹ️ Montos mínimos y máximos permitidos para cada método de pago.
- ℹ️ Estados transaccionales con claridad: por ejemplo, Transacción aprobada o Transacción rechazada, junto con una sugerencia de los pasos a seguir en caso de que corresponda.
- ❌ No almacenar datos sensibles del cliente en tu base de datos.
- ✅ La certificación se otorga únicamente si estos requisitos se cumplen en su totalidad en el entorno de sandbox.
- 💻 Una vez validada la integración, se habilitarán las credenciales para el entorno productivo.
- ⚠️ El incumplimiento de estos requisitos podrá resultar en la denegación de la certificación.
Updated about 12 hours ago