Retiros instantáneos con Wallet
Conoce el paso a paso de cómo hacer un retiro instantáneo con wallet en Perú.
Hacer un retiro en Perú a una wallet consiste en capturar los datos necesarios de la persona que recibirá 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.
ProntoPaga te permite hacer retiros instantáneos en Perú. Para ello, cuentas con dos modalidades disponibles:
- Retiros vía CCI (Cuenta bancaria / Cuenta interbancaria)
- Retiros vía wallet.
A continuación, puedes encontrar información detallada de cómo hacer retiros instantáneos desde el comercio a una wallet específica.
¿Cómo funciona?
Wallet (retiros instantáneos) es un método digital utilizado en Perú que permite retirar fondos desde una aplicación de billetera digital en el celular.
Para utilizar este método, el cliente debe seleccionar la opción "Billetera digital", tener una cuenta activa en una billetera compatible, ingresar su número de teléfono, seleccionar la billetera y confirmar la operación. Puedes consultar el listado de billeteras aceptadas en tus transacciones aquí.
El proceso de PayOut con wallet en Perú consta de cuatro etapas principales:
- Selección de método. El cliente elige retirar dinero por medio de wallet en tu sitio web o aplicación.
- Ingreso de datos. El cliente ingresa los datos necesarios para que el retiro sea realizado (como su número de teléfono y wallet) y confirma la transacción.
- Validación y Captura. ProntoPaga valida la información del retiro, hace la solicitud de transferencia a la wallet y mueve el dinero desde la cuenta del comercio hacia la cuenta del cliente.
- Confirmación. El cliente recibe una confirmación de retiro exitoso en su correo electrónico. A su vez, tu comercio recibe la confirmación a través de los webhooks que hayas configurado.
Entidades
En la tabla a continuación, podrás consultar las entidades aptas para transacciones a través de wallet, así como aquellas que requieren o no requieren validación de pagos a terceros.
| Entidad | Apta para wallet (con validación de terceros) | Apta para wallet (sin validación de terceros) |
|---|---|---|
| BANCO DE CREDITO DEL PERU | ✅ YES | ✅ YES |
| INTERBANK | ✅ YES | ✅ YES |
| SCOTIABANK | ❌ NO | ✅ YES |
| BBVA | ✅ YES | ✅ YES |
| BANCO NACION | ❌ NO | ✅ YES |
| BANCOM | ❌ NO | ✅ YES |
| BANCO PICHINCHA | ✅ YES | ✅ YES |
| BANBIF | ❌ NO | ✅ YES |
| CREDISCOTIA | ❌ NO | ✅ YES |
| MI BANCO | ❌ NO | ✅ YES |
| BANCO GNB | ✅ YES | ✅ YES |
| BANCO FALABELLA | ❌ NO | ✅ YES |
| BANCO RIPLEY | ✅ YES | ✅ YES |
| BANCO ALFIN | ✅ YES | ✅ YES |
| COMPARTAMOS FINANCIERA | ✅ YES | ✅ YES |
| TARJETA OH | ✅ YES | ✅ YES |
| FINANCIERA EFECTIVA | ✅ YES | ✅ YES |
| FINANCIERA CONFIANZA | ✅ YES | ✅ YES |
| PREXPE | ✅ YES | ✅ YES |
| CAJA PIURA | ✅ YES | ✅ YES |
| CAJA TRUJILLO | ✅ YES | ✅ YES |
| CMAC AREQUIPA | ❌ NO | ✅ YES |
| WAYKI CAJA CUSCO | ✅ YES | ✅ YES |
| CAJA HUANCAYO | ❌ NO | ✅ YES |
| CAJA ICA | ✅ YES | ✅ YES |
| CAJA LOS ANDES | ✅ YES | ✅ YES |
| YAPE | ✅ YES | ✅ YES |
| PLIN | ✅ YES | ✅ YES |
| COOPERATIVA ABACO | ✅ YES | ✅ YES |
| LIGO | ✅ YES | ✅ YES |
| DALE | ✅ YES | ✅ YES |
Wallets disponibles
Este es la lista completa de las wallets disponibles para hacer PayOuts con ProntoPaga en Perú:
| Marca | Valor |
|---|---|
| Banco Falabella | falabella |
| Wayki Caja Cusco | cajaCusco |
| Banco Nación | nacion |
| Mibanco | mibanco |
| Tarjeta oh | oh |
| Banco GNB | gnb |
| BanBif | banbif |
| Caja Lima | cajaLima |
| Compartamos Financiera | compartamos |
| Caja Huancayo | cajaHuancayo |
| Caja Piura | cajaPiura |
| Dale | dale |
| Financiera Confianza | confianza |
| Bancom | comercio |
| Ripley | ripley |
| Santander | santander |
| Banco Pichincha | pichincha |
| Banco de Crédito del Perú (BCP) | bcp |
| Financiera Efectiva | efectiva |
| Caja Ica | Caja Ica |
| Caja Trujillo | cajaTrujillo |
| Interbank | interbank |
| Luqea | luqea |
| Caja Sullana | cajaSullana |
| Prexpe | prexpe |
| Yape | yape |
| Plin | plin |
| Bim | bim |
Crea una solicitud
Si la transacción es exitosa, recibirás una respuesta similar a la siguiente:
{"data": "Array",
{
"0": "yape”,
"1": "plin”,
"2": "bim”,
"3": "luqea”,
"4": "dale”,
"5": "prexpe”,
"6": "oh”,
} Motivos de rechazo
A continuación se muestran varios posibles casos de rechazo de un retiro, junto con su respectivo código.
| Código | Descripción |
|---|---|
| 1 | El cliente se encuentra bloqueado |
| 2 | Excede límite %s, quedan disponibles %s para el día, %s para la semana, %s para el mes. Retiro máximo por transacción %s |
| 3 | El saldo a retirar excede el balance disponible en esta moneda |
| 4 | Cuenta ingresada no existe. |
| 5 | El número de cuenta del destinatario no corresponde al Rut ingresado. |
| 6 | Banco seleccionado no corresponde. |
| 7 | Cuenta con restricción de abono. |
| 8 | Banco de destino en mantención. |
| 9 | Rut Incorrecto. |
| 10 | Cuenta Rut Con Dígito Verificador. |
| 12 | Banco de destino no disponible. |
| 13 | Error interno, favor reintentar. |
| 16 | El número de teléfono no es válido en la cabina telefónica. |
| 17 | Error interno, validaciones fallidas. |
| 20 | Wallet no encontrada para este número. |
| 21 | Moneda ingresada es inválida |
| 22 | Cuenta inválida, bloqueada o cerrada |
| 23 | La información suministrada es insuficiente o inválida |
| 24 | El número de cuenta del destinatario no corresponde a los datos del usuario ingresado |
| 25 | ID inválido |
| 26 | Monto de retiro excede los límites, por favor reintentar con un monto válido |
| 27 | No se aceptan documentos de identidad correspondientes a empresas. Por favor, ingresa uno válido de persona natural para continuar. |
| 28 | Fallo en la validación de terceros por datos insuficientes del Banco |
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 siguente artículo:
Prueba tu integración
Contamos con un catálogo 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, también puedes hacer pruebas con nuestro demo.
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.
- ✅ 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.
Para comercios tipo gambling es necesario cumplir con los siguientes requisitos:
* ✅<b> Verificación de contacto mediante OTP</b>: El registro de usuarios debe incluir una validación de correo electrónico o número telefónico mediante código OTP.
* ✅<b> Verificación de identidad (KYC)</b>: Deben existir validaciones adicionales de identidad antes de permitir el uso completo de la plataforma o realizar transacciones.
* ⚙️<b> Controles para cambios de datos personales</b>: Para la modificación de información sensible (correo electrónico, teléfono, nombre, etc.), el sistema debe solicitar una verificación adicional, como OTP o confirmación de seguridad.
* ⚙️<b> Controles antifraude básicos en el proceso de registro</b>: Esto puede incluir validaciones adicionales para evitar registros automatizados o cuentas fraudulentas.
* ⚠️ El incumplimiento de estos requisitos podrá resultar en la denegación de la certificación.Updated 7 days ago