Retiros instantáneos con Wallet

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:

1. Selección de método. El cliente elige retirar dinero por medio de wallet en tu sitio web o aplicación.
2. 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.
3. 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.
4. 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.

Wallets disponibles

Este es la lista completa de las wallets disponibles para hacer PayOuts con ProntoPaga en Perú:

Consulta de wallets por número telefónico (Opcional)

Si deseas conocer las wallets asociadas al número telefónico celular del beneficiario, primero deberás consultar el endpoint de Lista de wallets y agregar el teléfono en la URL de la petición.

Respuesta

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”, 
 } 

Solicitud de retiro instantáneo vía wallet

Después de seleccionar una wallet del listado obtenido en el endpoint anterior, deberás hacer una petición al endpoint de Crear un nuevo retiro a wallet y enviar una solicitud con un body similar al siguiente.

{
  "amount": "150.90",
  "document_id": "12345678912",
  "beneficiaryName": "John",
  "beneficiaryLastName": "Doe",
  "beneficiaryEmail": "[email protected]",
  "beneficiaryPhone": "999999999",
  "data": "XYZ789",
  "confirmationURL": "https://www.webhook.com",
  "currency": "PEN",
  "country": "PE",
  "wallet": "luqea",
  "sign": "Signature of the parameters"
}

👍

Límite transaccional

Para los retiros con Yape, el monto máximo permitido por día y por transacción es de 3,000 PEN. Asegúrate de mostrar este límite de forma visible en el front-end y de implementar la lógica de validación y formato que impida ingresar montos superiores a 3,000 PEN antes de enviar la solicitud.

Si el cliente intenta superar los límites permitidos, se le mostrará un mensaje de rechazo.

Posibles respuestas

Como respuesta a una solicitud de pago exitosa, recibirás un identificador del retiro en el sistema, el estado del retiro y datos adicionales de la transacción.

Si la transacción es exitosa, recibirás la siguiente respuesta:

{
  "uid": "01J4PG5MET5CV6BCCQB8HRFC2X",
  "status": "new",
  "data": "XYZ789",
  "reference": 8290,
  "plin": true
}

Si la transacción es rechazada, recibirás la siguiente respuesta:

 {
    "beneficiaryPhone":  "(string) beneficiaryPhone, cannot be null."
 }

Motivos de rechazo

A continuación se muestran varios posibles casos de rechazo de un retiro, junto con su respectivo código.

Confirmación de un retiro

Una vez que hayas completado el proceso, ProntoPaga devolverá los datos de la transacción a la URL que especificaste en confirmationURL.

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 retiro en el siguiente enlace: Estados de los PayOuts.

Webhook

Al finalizar una transacción exitosa, recibirás un webhook similar al ejemplo mostrado a continuación.

{      
      "uid": "01J8MWMSW7KCVG6YE6X1GZABCD",
      "status": "success",
      "data": "XYZ789",
      "statusCode": "200",
      "startNotificationTime": "2024-08-25 12:16:54",
      "endNotificationTime": "2024-08-25 12:16:54",
      "totalRequestTime": "0.791377",
      "sign": "e198c7a2c33d697c551c445b37659e06bf7c1e92db8bae00c7a1f5411b1e7a00"
}         

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, también 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: