Transferencia (Paga con Tu Banco)
Crear un pago en Perú por medio de transferencia bancaria 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.
Además, todas tus transacciones cuentan con la herramienta automatizada Decision Manager (DM) del motor de gestión de riesgos y prevención de fraude de Cybersource (A Visa Solution).
¿Cómo funciona?
Paga con Tu Banco (Transferencia) es un método utilizado en Perú donde se realiza transferencia electrónica de fondos entre cuentas bancarias. Para completar una transacción utilizando este método de pago, el cliente debe seleccionar la opción "Paga con tu Banco", ingresar a su cuenta con su número de identificación, número de tarjeta y la clave de internet de 6 dígitos. Luego, debe seleccionar la cuenta desde la cual desea realizar la transferencia e ingresar su token para autorizar la operación.
El proceso de pago con transferencia en Perú consta de cuatro etapas principales:

- Selección de método. El cliente elige pagar con transferencia en tu sitio web o aplicación.
- Selección de banco. Se le muestra un listado de bancos al cliente, en donde podrá seleccionar el suyo.
- Redirección. El cliente es redirigido al portal de su banco, en donde deberá iniciar sesión y seguir las instrucciones en pantalla para hacer la transferencia. El dinero se mueve desde el banco 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.
De este modo, para crear una solicitud de nuevo pago deberás usar este endpoint y colocar PagaConTuBanco
como método de pago en el body de la solicitud.
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.
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.
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": "PEN",
"country": "PE",
"amount": "100.90",
"clientName" : "John Doe",
"clientEmail" : "[email protected]",
"clientPhone" : "999999999",
"clientDocumentType": "DN",
"clientDocument" : "12345678912",
"paymentMethod" : "PagaConTuBanco",
"urlConfirmation" : "https://www.webhook.com",
"urlFinal" : "https://sandbox.prontopaga.com/successful",
"urlRejected" : "https://sandbox.prontopaga.com/declined",
"order" : "XYZ789",
"sign" : "Signature of the parameters"
}
Solicitud a un banco específico (Direct Banks - Chile y Perú)Para hacer una solicitud a un banco específico, primero debes consultar el endpoint de Lista de códigos bancarios, tomar el valor del campo
code
y colocarlo en el parámetrobankCode
de este endpoint.
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.
Pago en el banco
El cliente podrá continuar el proceso siguiendo las instrucciones en pantalla. Se redireccionará al cliente al sitio web de la institución bancaria que haya seleccionado para pagar, en donde podrá iniciar sesión y hacer la transferencia.
Confirmación de un pago
Una vez que el usuario haya completado el proceso de pago en su banco, 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 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