Changelog

1. Se agregó a la documentación el Manual de contracargos para comercios.

Asimismo, se incorporó la sección de Virtual accounts (BETA), con sus respectivas guías de Cuentas virtuales, Cambio de divisas (FX), Webhooks y ejemplos de body request y sus respuestas.

Las cuentas virtuales son números de cuenta únicos que permiten recibir y gestionar pagos de forma segura, facilitando la conciliación entre empresas y clientes.

Además, se incorporaron:

• Ejemplos de body request y responses.

• Flujos de pago y cambio de divisas.

  Y en la Referencia API los endpoints de:

• Autenticación

• Cuentas virtuales

• Reembolso

• FX

• Wire Out

• Reportes

1. Se agregó la guía del método de Recibe pagos con código de pago. Asimismo, se incorporó un ejemplo de body request para el endpoint de Crear un nuevo pago.

Este método permite a los usuarios realizar pagos mediante un código a través de los aplicativos del banco BCP.

Además, se incorporaron:

• Ejemplos de body request y responses.
• El flujo de pago completo.
• Las distintas modalidades disponibles.

1. Se agregó la guía de 3DS para métodos de pago con tarjeta en la sección de seguridad. Esta incluye:
   1. Flujo de autenticación con 3DS.
   2. Países disponibles.
   3. Ejemplos de respuestas.
   4. Manejo de errores.

1. Se incorporó el servicio de Botón Yape: One Shot en Perú. Para ello:
   1. Se creó la guía de integración con el nuevo método de pago con Wallet.
   2. Se agregó la sección Pagos únicos en la página de Acepta pagos con Wallet en Perú.
   3. Se agregó el body request en el endpoint de Crear un nuevo pago, así como su respuesta 200 y 400.
2. Se creó un artículo con los tiempos de liquidación, horarios de corte y condiciones operativas por país y método de pago.

Se estandarizó la sección de Motivos de rechazo en la guías, tanto en PayIns como PayOuts. Además, los códigos de error se encuentran recopilados en los artículos Tipos de rechazo (PayIns) y Tipos de rechazo (PayOuts), respectivamente.

Se añadió la documentación del nuevo flujo embebido de Webpay para pagos con tarjeta en Chile. Este flujo permite integrar Webpay dentro del sitio del comercio mediante un iFrame, sin redirecciones externas. Se incluyó la descripción del comportamiento, los ejemplos de body request y los bancos disponibles.

1. Se incorporó el servicio de retiros con Pix QR/Wallet en Brasil. Para ello:
   1. Se incorporó el endpoint de retiro Crear un nuevo retiro - Brasil Pix (/withdrawal/pix/new) en la Referencia API.
   2. Se agregó un ejemplo de body request en el endpoint de Crear un nuevo retiro - Brasil Pix.
   3. Se agregaron los pasos para su integración en la Guía de retiros con Pix - Brasil.
   4. Se creó una guía de códigos bancarios para retiros en Brasil.
   5. Se agregaron datos de prueba para este servicio.
   6. Se agregó el endpoint a nuestra colección de Postman.
2. Además, se incorporó el servicio de pagos con Pix QR/Wallet en Brasil. Para ello se realizaron las siguientes acciones:
   1. Se incorporó el método br\_pix\_payment al endpoint de pago api/payment/new en la Referencia API.
   2. Se incorporó el nuevo endpoint /api/payment/pix-payment/accounts?taxId={}</para consultar cuentas bancarias en Brasil.
   3. Se agregó este método al endpoint /api/reverse/new (devolución de un pago).
   4. Además, se incorporaron ejemplos Pix en los endpoints de devolución y detalles de un pago de la Referencia API.
   5. Se agregaron ejemplos de body request y respuestas en los endpoints creados para pagos con Pix.
   6. Se agregaron los pasos para su integración en la Guía de pagos con Pix - Brasil.
   7. Se creó una guía de códigos bancarios para PayIns en Brasil.
   8. Se agregaron datos de prueba para este servicio.
   9. Se agregaron los endpoints a nuestra colección de Postman

Se removieron los métodos de tarjeta y wallet para Ecuador a través de Payphone, en Ecuador. Para ello:

• Se eliminó el servicio de payin del endpoint de Crear un nuevo pago.
• Se eliminó el endpoint Crear un nuevo retiro - Ecuador Payphone.
• Se eliminó la Guía de integración de los métodos PayIn y PayOut.
• Se eliminaron los endpoints de Payphone en nuestra colección de Postman.

1. Se creó la guía Acepta pagos con QR/Wallet, que incluye el nuevo método de pago con QR MODO en Argentina.
2. Se agregó al artículo de la Referencia API el nuevo método de pago para Argentina:
   1. ar\_qr\_2\_payment
3. Se crearon tres artículos nuevos en la Referencia API con los endpoints de:
   1. Consultar un pago con QR/Wallet - QR MODO
   2. Ver flujo final QR/Wallet - QR MODO
   3. Cancelar un pago con QR/Wallet - QR MODO

1. Se creó el artículo de Biometría, donde los comercios pueden implementar una verificación biométrica con sus clientes, para mantener sus transacciones aún más seguras.
   1. Se creó artículo en la Referencia API con el endpoint de Crear una nueva biometría.
   2. Se creó el artículo en la Referencia API con el endpoint de Detalles de una biometría.
2. Se creó el artículo de Pay4U, mostrando la funcionalidad exclusiva de ProntoPaga, que permite proporcionar un servicio de pago a terceros.
3. Se creó el artículo de marcas de tarjetas aceptadas por ProntoPaga en Chile, Ecuador y Perú.

Se actualizó el artículo de ¿Cómo usar nuestra documentación? en la Referencia API por un video interactivo, donde se muestra una guía rápida para conocer la documentación técnica dentro de ProntoPaga.

Se removió el endpoint REVERSE (devolución) de los siguientes métodos:

• Tarjeta Perú
• QR (PE)
• Payphone Wallet
• Payphone Tarjeta

1. Se creó el manual del Portal de servicios de ProntoPaga, que permite a todos los comercios conocer las secciones y módulos del portal, así como las acciones que se pueden realizar. El manual incluye las siguientes secciones:
   1. Portal de servicios
   2. Sección PRINCIPAL
   3. Sección TRANSACCIONES
   4. Sección REPORTES
   5. Sección ENTIDADES
   6. Sección USUARIOS
2. Se creó la sección de preguntas frecuentes en la pestaña superior FAQs, donde los usuarios pueden encontrar información relacionada a las consultas más comunes con respecto a las integraciones y Referencia API de ProntoPaga.
3. Se creó la sección de ¿Necesitas ayuda? en la pestaña superior Help, donde los usuarios pueden encontrar los medios de contacto con el equipo de Customer support, así como los canales de atención de ProntoPaga.

Se agregaron los códigos de error en la tabla Motivos de rechazo de un pago, para los métodos de pago con Wallet de Perú:

• Yape On File: One Click Payments
• Yape On File: Recurrencia

1. Se agregó el Glosario de pagos digitales dentro de la sección de Guías.

Se agregó la página de Customer Support de Prontopaga para la atención de comercios.
Se agregaron canales de contacto e información sobre los tipos de atención.

1. Se creó el artículo de Status Page, donde podrás consultar el historial de incidencias, incidencias en curso, incidencias resueltas y mantenimientos programados. También podrás descubrir cómo suscribirte para recibir actualizaciones sobre incidencias y mantenimientos.
2. Se actualizó el artículo de cobertura por país donde podrás consultar la cobertura que tenemos actualmente en los diversos países en los que operamos.

Se realizaron cambios en el back-end de nuestro sitio de documentación, el cual fue migrado a un nuevo formato. Es posible que, mientras se estabiliza el sistema, experimentemos algunas fallas. Estaremos trabajando activamente en resolverlas y otorgarles la mejor experiencia.

1. Se agregó el servicio de Yape On File: One Click Payment, el cual permite afiliar la cuenta de Yape de tu cliente con tu comercio, para que después pueda hacer pagos en un solo clic. Para ello:
   1. Se creó la guía de integración de Yape On File: One Click Payment.
   2. Se creó el endpoint de Afiliaciones.
   3. Se creó el endpoint de Lista de afiliaciones.
   4. Se creó el endpoint de Detalles de una afiliación.
   5. Se creó el endpoint de Cancelar una afiliación.
   6. Se realizaron ajustes en el endpoint de Devolución de un pago.
2. Se agregó el servicio de Yape On File: Recurrencia, el cual permite afiliar la cuenta de Yape de tu cliente con tu comercio, para que se le realicen pagos periódicos (de suscripciones a servicios, por ejemplo). Para ello:
   1. Se creó la guía de integración de Yape On File: Recurrencia.
   2. Se creó el endpoint de Afiliaciones.
   3. Se creó el endpoint de Lista de afiliaciones.
   4. Se creó el endpoint de Detalles de una afiliación.
   5. Se creó el endpoint de Cancelar una afiliación.
   6. Se realizaron ajustes en el endpoint de Devolución de un pago.

Se agregó el servicio de validación de pago de terceros, para los servicios de: Yape On File: One Click Payment y Yape On File: Recurrencia. Para ello, se modificaron las guías para indicar el nuevo flujo que seguiría cada caso, dependiendo de si tiene el servicio activo o no.

❗️

Función Beta

Actualmente, esta función está en Beta, bajo pruebas supervisadas con comercios específicos. Cuando esté disponible para todos, será notificado y agregado a la versión principal de esta documentación.

1. Se incorporó la opción de insertar el checkout de Webpay en un iFrame, dentro de tu mismo sitio web. Esto evitará redireccionar al cliente durante su pago con tarjeta en Chile, con el servicio de Webpay. Para ello:
   1. Se modificó la Guía de Tarjeta de Chile.
   2. Se modificó el parámetro theme en el endpoint de Crear un nuevo pago.
   3. Se agregó un ejemplo específico para este caso de body request en el endpoint de Crear un nuevo pago.
   4. Se agregó el ejemplo de request y responses a nuestra Colección de Postman.

Se incorporó la opción de obtener directamente el código QR en la respuesta, al crear un pago con QR en Perú. Este código podrá ser insertado directamente en la página web o aplicación del comercio, usando una etiqueta IMG. Para ello:

• Se creó la Guía Crea un nuevo pago (recibe directamente el QR).
• Se modificó el parámetro theme en el endpoint de Crear un nuevo pago.
• Se agregaron ejemplos específicos para este caso de body request y response en el endpoint de Crear un nuevo pago.
• Se agregó el ejemplo de request a nuestra Colección de Postman.

Ahora un pago con QR puede ser cancelado, en caso de que el cliente no lo haya completado al momento. Es decir, si un cliente generó un QR y le tomó captura de pantalla, pero no realizó el pago al momento, puedes cancelar ese QR para evitar que el cliente intente pagar más tarde con la imagen del QR. Para ello:

• Se creó el endpoint Cancela un pago con QR - Perú.
• Se agregó la sección de Cancelar un pago con QR a la Guía de integración de pagos con QR en Perú.
• Se agregó el endpoint a nuestra Colección de Postman.

Se agregó la opción de indicar una cantidad de registros por página en el endpoint para consultar transacciones por fecha:

• Se modificó el endpoint de Consultar transacciones por fecha.
• Se modificó el endpoint indicado en nuestra Colección de Postman.

Se agregó un servicio de búsqueda y consulta de pagos por medio del número order.

• Se creó el endpoint de Detalles de un pago (order).
• Se agregó el nuevo endpoint a nuestra Colección de Postman.

Se removió el servicio de pagos con efectivo a través de Servifácil, en Chile. Para ello:

• Se removió el servicio de payin del endpoint de Crear un nuevo pago.
• Se removió la Guía de integración del método.
• Se eliminó el endpoint del método en nuestra colección de Postman.

Se ajustaron los endpoints para el servicio de pago con tarjeta (Webpay) en Chile:

• El endpoint de Crear un nuevo pago será usado para el servicio de pago con tarjeta usando Webpay.
• En caso de que el comercio deba incorporarse a través del servicio de Webpay Mall, cuenta con otro endpoint específico para dicho servicio.
• Se modificó la Guía de integración, para incluir las instrucciones para ambos métodos.

🚧

Webpay y Webpay Mall

Por favor, consulta con nuestros asesores si tu comercio debería integrar pagos con tarjeta en Chile a través del servicio de Webpay o de Webpay Mall. Esta decisión es interna y no afectará la transaccionalidad de tu comercio.

Se incorporó el servicio de pagos con tarjeta con Payphone, en Ecuador. Para ello:

• Se incorporó el método de pago ec_card_payment en el endpoint de Crear un nuevo pago.
  

  

• Se agregó un ejemplo de body request en el endpoint de Crear un nuevo pago.
  

  
  • Se agregaron los pasos para su integración en la Guía de pagos con Tarjeta Ecuador.
    
  • Se agregaron Datos de prueba para este servicio.
    

• Se agregó el endpoint a nuestra Colección de Postman.
  

1. Se añadió un parámetro al endpoint de Crear un nuevo pago:

 * Se agregó el parámetro clientDocumentType al endpoint de Crear un nuevo pago. Este parámetro enviará el tipo de documento de identidad del cliente (DNI, carné de extranjería o pasaporte). Es obligatorio solo para Perú.

 * Se modificó el ejemplo de body request del mismo endpoint, para el servicio Paga con tu banco de Perú, añadiendo el parámetro clientDocumentType.