Cómo funcionan los payins | ProntoPaga Docs

¿Qué es un PayIn?

Un PayIn o pago es una transacción entrante que permite recibir fondos en una cuenta financiera asociada al comercio por concepto de la compra o pago de un producto o servicio. En ProntoPaga, los PayIns pueden procesarse mediante distintos métodos de pago, como tarjetas, transferencias bancarias, efectivo, QR o wallets, según el país y la configuración del comercio.

Flujo de un PayIn

A continuación, podrás ver un diagrama del funcionamiento general de un PayIn.

Tipos de PayIns

ProntoPaga te permite recibir pagos mediante distintos tipos de PayIns. La disponibilidad de cada tipo de PayIn puede variar según el país, la moneda, el método habilitado para el comercio y la configuración de la integración.

A continuación, se muestra una tabla con los diferentes tipos de PayIns disponibles en ProntoPaga:

Tipo de PayIn	Modalidades	Descripción
Tarjeta	Crédito, débito	Permite procesar pagos online con tarjeta. Consulta las marcas de tarjetas aceptadas en el siguiente artículo.
Transferencia bancaria	Paga Con Tu Banco	Permite al cliente completar el pago desde su banco preferido. La confirmación es inmediata.
Efectivo	Pago en establecimientos autorizados	Genera una referencia para que el cliente complete el pago en un punto físico autorizado.
QR	Pago mediante código QR	Permite al cliente completar el pago escaneando un código desde una app bancaria o wallet compatible.
Wallet	Billetera digital local	Permite pagar desde una billetera digital disponible en el país del cliente.
Código de pago	Código o referencia bancaria	Genera un código o referencia para que el cliente complete el pago desde canales bancarios habilitados.

📘
Métodos de PayIns
Conoce todos los métodos de PayIns disponibles por país.

Diferencias entre métodos de PayIns

Dependiendo del tipo de PayIn requerido, existen características únicas asociadas a cada uno. A continuación visualizarás las principales diferencias entre los métodos de PayIns disponibles:

Tipo de PayIn	Confirmación	Acción del cliente	Recomendación
Tarjeta	Inmediata	Ingresar a su app o web bancaria o confirmar los datos de la tarjeta	Compras online, checkout rápido y pagos con baja fricción
Transferencia bancaria	Inmediata o posterior	Completar el pago desde su banca móvil	Pagos bancarios o montos elevados
Efectivo	Posterior	Pagar una referencia en un establecimiento autorizado	Clientes sin tarjeta o sin cuenta bancaria
QR	Inmediata	Escanear el código de pago desde una aplicación compatible	Experiencia enfocada en los móviles
Wallet	Inmediata	Autorizar el pago desde una billetera digital	Usuarios recurrentes
Código de pago	Posterior	Usar un código en canales bancarios compatibles	Pagos diferidos

Métodos síncronos o asíncronos

Los PayIns pueden comportarse de forma síncrona o asíncrona dependiendo del método utilizado. En la siguiente tabla puedes visualizar las diferencias:

Tipo de confirmación	Descripción	Ejemplo
Síncrona	El estado `success` es recibido inmediatamente o pocos segundos después.	Tarjeta, QR, wallet
Asíncrona	El estado queda en estado `pending` hasta que el cliente completa una acción externa. Una vez confirmada la acción, el estado cambia a `success`.	Efectivo, código de pago, algunas transferencias

📘
Estados de los PayIns
Conoce el significado de cada estado de una transacción de PayIn en el siguiente artículo.

3.2.1. Flujo de PayIn síncrono

A continuación, podrás visualizar un diagrama con un flujo de PayIn síncrono.

3.2.2. Flujo de PayIn asíncrono

A continuación, podrás visualizar un diagrama con un flujo de PayIn asíncrono.

Webhooks

Los webhooks son un mecanismo de notificación automática cuando ocurre un evento en la plataforma (ejemplo: pago aprobado, contracargo iniciado, pago rechazado), ProntoPaga envía un mensaje POST a una URL configurada por el comercio.

El siguiente flujo es un ejemplo de cómo funciona un webhook de confirmación de PayIn:

📘
Webhooks
Si deseas conocer más información de cómo funcionan los webhooks y sus configuraciones específicas, puedes consultar el siguiente artículo .

Integración de PayIns

Para integrar PayIns, debes crear una transacción desde la API de ProntoPaga, enviar los datos requeridos del pago y prepararte para recibir la configuración del resultado. 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.

El flujo puede variar según el tipo de PayIn seleccionado, así como la información requerida, pero ten en cuenta los siguientes datos sugeridos:

Elemento	Descripción
Credenciales de autenticación	Permiten autenticar las solicitudes enviadas. Se trata de tu Bearer Token y secretKey. Conoce más acerca de las credenciales en el siguiente artículo.
Método de PayIn	Define el tipo de PayIn que utilizará el cliente. Conoce los métodos de PayIn aquí.
País y moneda	Deben estar en el formato ISO requerido. Consulta más información aquí.
Datos del cliente	Información requerida para crear el pago, como nombre, correo, teléfono o documentación. Consulta más información en la API Reference de crear un nuevo pago .
Monto	Monto de la transacción.
URL de retorno	URL de redirección después de que el pago sea completado.
URL de confirmación	Webhook. Conoce más información en este artículo.

📘
Requisitos de un PayIn
Para conocer los requisitos específicos de tu integración, consulta la guía particular del método de PayIn en el país disponible. También, puedes consultar la sección de PayIns de la API Referece con todos los endpoints y parámetros requeridos.

Demo

Puedes probar algunos de los métodos de pago disponibles y hacer un ejemplo de cómo vería el proceso tu cliente final en el siguiente demo:

📘
Pantalla de resultado
Durante el flujo de PayIns (pagos), contamos con una pantalla de resultado estandarizada que puedes utilizar. Adicionalmente, puedes desarrollar y gestionar tu pantalla de resultado de manera independiente.