Acepta pagos con código de pago

Crear un pago con código de pago en Perú 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.

La solicitud de pago podrá realizarse tanto en la versión web como en la mobile. Una vez realizada con éxito, el cliente podrá realizar sus pagos ingresando el código en diferentes plataformas integradas del BCP (Banco de Crédito del Perú) sin necesidad de usar tarjeta bancaria.

👍
Vigencia del código
El código de pago incluye el monto a pagar y la fecha y hora de expiración. Además, es válido por 30 minutos.

¿Cómo funciona?

BCP es un banco que opera en Perú y permite realizar pagos de cargos o consumos mediante código de pago en sus distintas plataformas digitales. Para completar un pago con cualquiera de estas plataformas, el usuario debe iniciar sesión en cualquier canal como:

Yape
VíaBCP (Banca por internet)
Telecrédito web BCP (Banca negocios)
Banca Móvil BCP (App)

El proceso de pago con código en Perú consta de cinco etapas principales:

Selección de método. El cliente elige pagar vía banca por internet/móvil BCP en tu sitio web o aplicación.
Solicitud. ProntoPaga genera el código de pago y muestra al cliente el monto a pagar, la fecha y hora de expiración para realizar el pago.
Cuenta. El cliente inicia sesión en su plataforma de pago elegida. A continuación, puedes conocer el flujo según el canal donde pagará el cliente:

📱 Yape

El cliente abre su app Yape y elige la opción Yapear servicios. En el buscador ingresa ProntoPaga y luego digita el código de pago para completar la transacción.

📱 Banca Móvil BCP (App)

El cliente inicia sesión en su app de Banca Móvil BCP y selecciona la opción Pagar servicios. En el buscador ingresa ProntoPaga y digita el código de pago para finalizar la transacción.

💻 VíaBCP Banca por internet

El cliente ingresa a su banca por internet del BCP y selecciona la opción Pagar servicios. En el buscador ingresa ProntoPaga y digita el código de pago para continuar la transacción.

🌐 Telecrédito web BCP

El cliente inicia sesión en Telecrédito web y selecciona la opción Pagar servicios. En el buscador ingresa ProntoPaga y luego digita el código de pago para completar la transacción.

Pago. ProntoPaga valida la información del pago.
Confirmación. El cliente recibe el comprobante 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 pe_service_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ón
Puedes 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ón
Para configurar el webhook que irá en el campo urlConfirmation y recibir notificaciones con el estado de tu transacción, revisa este artículo.

Tipos de respuestas

En esta guía se muestran varios posibles casos de rechazo junto con su código y descripción.

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:

Límites transaccionales

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 generen transacciones realizadas por menores de edad o a su nombre.