Cómo funcionan los payouts

¿Qué es un PayOut?

Un PayOut o retiro es una transacción que permite enviar dinero desde la cuenta del comercio hacia la de un beneficiario (individuo o entidad). En este sentido, los comercios que se integran con ProntoPaga suelen hacer PayOuts para, por ejemplo:

Hacer un pago a sus proveedores por productos o servicios.
Transferir a sus subcomercios las ganancias de los productos o servicios que vendieron en determinado tiempo.
Transferir a sus clientes los rendimientos de inversiones monetarias.

Flujo de un PayOut

A continuación visualizarás un diagrama con el funcionamiento general de un PayOut.

Tipos de PayOuts

ProntoPaga te permite enviar pagos mediante distintos tipos de PayOuts. La disponibilidad de cada tipo de PayOut puede variar según el país, 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 PayOuts disponibles en ProntoPaga:

Tipo de PayOut	País	Descripción
Transferencia bancaria	CL/EC/PE	Permite enviar fondos a una cuenta bancaria o interbancaria del beneficiario.
Pix	BR	Permite realizar retiros instantáneos mediantes Pix.
Wallet	PE	Permite enviar fondos a una billetera digital compatible.
Efectivo	EC	Permite retiros en establecimientos autorizados.

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

Tipos de cuenta y códigos bancarios

Algunos PayOuts requieren incluir dentro del body request información del tipo de cuenta del beneficiario y código bancario.

Parámetro	Descripción
`accountType`	Los tipos de cuentas válidos dependen del país. Puedes consultar la lista de cuentas disponibles .
`pagamentoType`	Tipos de cuenta válidos para Pix en Brasil. Puedes consultar la lista de cuentas disponibles.
`bankCode`	Es el código del banco al cual se enviará el PayOut. Conoce la lista completa de códigos bancarios.

Estados de los PayOuts

Los PayOuts cuentan varios estados, dependiendo el momento de la transacción. Consulta más información acerca de los estados en el siguiente artículo.

Webhooks

Los webhooks son un mecanismo de notificación automática cuando ocurre un evento en la plataforma (ejemplo: retiro exitoso, 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:

📘
Tipos de rechazo
Conoce los tipos de retiros rechazados.

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

📘
Webhooks
Obtén más información de cómo funcionan los webhooks y sus configuraciones específicas.

Integración de PayOuts

Para integrar PayOuts, debes crear una transacción desde la API de ProntoPaga, enviar los datos requeridos del retiro 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 retiro.

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

Elemento	Descripción
Monto	Monto de la transacción.
Datos del cliente	Información requerida para crear el retiro, como nombre, correo, teléfono o documentación. Consulta más información en la API Reference de crear un nuevo retiro.
Número de cuenta	Número de cuenta bancaria del beneficiario.
Tipo de cuenta	Tipo de cuenta bancaria del beneficiario.
Código bancario	Código bancario. Conoce la lista completa de códigos bancarios por país.
URL de confirmación	Webhook. Conoce más información en este artículo.

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

Demo

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