Acepta pagos con PIX | ProntoPaga Docs

Crear un pago en Brasil con Pix consiste en capturar los datos necesarios del cliente para el pago y enviar 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.

Hay dos formas de integrar este método en tu comercio:

QR estándar (flujo completo): Para quienes desean usar nuestra interfaz ya construida, en donde se genera y se muestra el QR automáticamente al usuario final. Incluye experiencia visual y seguimiento del estado del pago. Este flujo admite pagos con o sin cuenta bancaria registrada.
QR Base64: Para quienes necesitan solo el código QR en formato Base64, para integrarlo en su interfaz personalizada. Ideal si tienes tu propio front-end o flujo de usuario, y solo necesitas el QR para mostrarlo en donde prefieras. Este flujo también admite pagos con o sin cuenta bancaria registrada.

¿Cómo funciona?

Pix es un sistema de pagos instantáneos, creado y administrado por el Banco Central de Brasil, mediante el cual puedes realizar transacciones en tiempo real mediante códigos QR. Para completar una transacción con este método de pago, el cliente debe tener una cuenta bancaria o de una institución financiera en Brasil, registrarse en el sistema Pix y aprobar la transacción desde su aplicación.

El proceso de pago con Pix consta de cinco etapas principales:

Selección de método. El cliente elige pagar con Pix en tu sitio web o aplicación.
Generación de QR. ProntoPaga le entrega un QR y un código único al cliente. Este código tiene una duración de 30 minutos para usarse, de lo contrario, pasará a expirado.
Pago en aplicación. El cliente podrá escanear el QR con la aplicación de su banco,wallet o ingresar directamente el código único en su aplicación o banca en línea. El cliente realiza el pago siguiendo las instrucciones en pantalla.
Captura. El dinero se mueve desde la cuenta del cliente hacia la cuenta de tu comercio.
Confirmación. El cliente recibe una confirmación 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.

Requisitos regulatorios para comercios gambling

Debido a la regulación brasileña para comercios de tipo gambling, se incluye una validación de pago a terceros mediante el cual se verifica que la información de la cuenta bancaria del pagador pertenezca al mismo titular del CPF (Cadastro de Pessoa Física). Para ello, ProntoPaga te permite mapear hasta tres cuentas bancarias por usuario.

📘
E-commerce
Para comercios e-commerce, no se aplican restricciones relacionadas con pagos a terceros ni límites en la consulta de cuentas bancarias.

Consultar cuentas registradas

Puedes enviar una solicitud de pago con cuenta bancaria registrada o sin cuenta bancaria registrada. Para consultar si un usuario tiene o no cuentas bancarias registradas en Brasil consulta el paso a paso líneas abajo.

Términos y condiciones

Podrás hacer uso de este endpoint de consulta siempre y cuando el usuario final haya aceptado los términos y condiciones de la Política de Privacidade e Proteção de Dados de ProntoPaga. Del mismo modo, deberás elaborar tus propios términos y condiciones y notificarlos a tu usuario.

QR estándar (flujo completo)

Si buscas una integración práctica y eficiente, contamos con una interfaz lista para usar, que genera y muestra automáticamente el código QR al usuario final. Esta solución ofrece una experiencia visual atractiva; además, te permite monitorear en tiempo real el estado del pago, facilitando una implementación rápida sin comprometer la calidad ni la experiencia del usuario.

Crear 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 se integrará con nuestra API para procesarlo.

QR Base64

En esta modalidad, al hacer una solicitud de pago y mandar dentro del parámetro theme el valor "{\"type\":\"qr\"}", recibirás en la respuesta de la solicitud el código QR, que podrás renderizar en tu front-end presentarlo directamente en tu página web o aplicación.

Crear 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 se integrará con nuestra API para procesarlo.

Tipos de cuentas

Estos son los posibles tipos de cuentas que se pueden enviar en el parámetro accountType del body request:

payment
checking
salary
savings

📘
Parámetro requerido
El parámetro accountType es necesario para pagos con cuentas bancarias registradas.

Códigos bancarios

Para crear pagos con cuenta bancaria registrada, debes enviar el código bancario en el parámetro bankCode. Puedes consultar todos los bancos disponibles y sus valores en nuestra guía.

Reglas de validación

A continuación, te mostramos las reglas que debes tener en cuenta para los valores en el body de la solicitud.

Campo	Regla de validación
`accountType`	Obligatorio para pagos con cuentas bancarias registradas.
`accountNumber`	Debe contener exactamente desde 7 a 30 caracteres.
`clientDocument`	Acepta números, puntos y guiones.
`branchCode`	Debe contener 4 dígitos.
`address`	Se admiten entre 0 y 256 caracteres.
`city`	Se admiten entre 0 y 50 caracteres.
`bankCode`	Debe ser un ISPB válido y contener entre 5 y 8 caracteres.

Tipos de rechazos

La siguiente tabla muestra los tipos de rechazo que pueden derivarse de pagos con Pix en Brasil.

Código	Descripción
`FON0001`	FONDO INSUFICIENTE, CONTACTA A TU BANCO
`FON0002`	CUENTA CERRADA, CONTACTA A TU BANCO
`FOR0002`	DATOS INVALIDOS. VERIFICA E INTENTE NUEVAMENTE
`FOR0003`	MONTO INVALIDO
`FRA0001`	TRANSACCION DENEGADA, NO INSISTIR
`FRA0003`	USUARIO BLOQUEADO, NO INSISTIR
`FRA0004`	CUENTA BLOQUEADA, CONTACTA A TU BANCO
`FRA0006`	BLOQUEAR A USUARIO
`RES0001`	EXCEDE MONTO MAXIMO, CONTACTA A TU BANCO
`RES0002`	OPERACION NO PERMITIDA
`RES0005`	NO CUMPLE REQUISITOS DE EDAD, NO INSISTIR
`RES0009`	EXCEDE MAXIMO DIARIO DE TRANSACCIONES, CONTACTA A TU BANCO
`SIS0002`	ERROR DEL SISTEMA DE CONEXION EMISOR, INTENTE MAS TARDE
`SIS0003`	PROBLEMA EN LA TRANSACCION, CONTACTA A TU BANCO
`SIS0004`	RECHAZO GENERAL, CONTACTA A TU BANCO
`SIS0006`	ERROR DEL SISTEMA DE CONEXION, INTENTE MAS TARDE
`SIS0009`	TRANSACCION ANULADA
`TEC0001`	TRANSACCION INCONSISTENTE, NO INSISTIR
`TEC0002`	TRANSACCION NO SOPORTADA, NO INSISTIR
`TIM0001`	TIEMPO DE ESPERA AGOTADO
`TIM0002`	TRANSACCION EXPIRADA. INTÉNTALO DE NUEVO
`USU0002`	TRANSACCIÓN CANCELADA POR EL USUARIO
`USU0004`	CUENTA NO EXISTE, CONTACTA A TU 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:

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 realicen transacciones en nombre de terceros o menores de edad.