Payouts - Colombia
Payouts es un servicio de integración disponible bajo demanda y su activación depende de un análisis de riesgo y seguridad. Para más información o para solicitar este servicio, comunícate con tu Representante de Ventas.
Expliquemos Payouts a través de un ejemplo. Un comercio ofrece productos y servicios a domicilio; este comercio utiliza PayU como su plataforma de pagos y tiene una cuenta donde recauda el dinero pagado por sus clients. Este comercio tiene varios repartidores a quienes paga un monto fijo por cada domicilio que realicen.
Cada semana, el comercio paga el monto obtenido por cada repartidor. Para esto, ellos pueden utilizar Payouts para pagar directamente desde su cuenta de PayU en lugar de administrar los pagos por su cuenta, en cuyo caso, el comercio debe transferir el dinero a sus cuentas bancarias o utilizar los fondos recolectados de otras fuentes.
Para solicitar el pago, el comercio envía la lista de beneficiarios a los que desea pagar junto con el monto de cada uno. PayU valida estos beneficiarios y programa el pago.
El valor de cada pago más la tarifa de procesamiento es debitado de la cuenta. Contacta a tu Represente de Ventas para saber el valor de la tarifa de procesamiento para utilizar este servicio.
Beneficios
- Aprovecha las capacidades regionales.
Payouts es una API completa y fácil de utilizar para realizar pagos a cualquier banco en el país de procesamiento*.
*Disponible por ahora en Colombia, próximamente en otros mercados. - Uno or múltiples pagos.
La API es flexible. Puedes crear uno o múltiples solicitudes de pago para beneficiarios nuevos o existentes. No hay restricción en el número de registros. - Ahorra tiempo y costos.
Puedes ahorrar costos operacionales y tiempo gestionando todas las operaciones de pago en un solo lugar. - Administra mejor los fondos y el saldo de la cuenta.
Puedes cancelar órdenes de pago antes de que sean enviadas al banco. Payouts te ayuda a manejar mejor los fondos y el saldo de tu cuenta. - Notificaciones personalizadas.
Cualquier cambio en la orden de pago es actualizado por nuestra solución. Puedes personalizar las notificaciones que recibes.
¿Cómo funciona Payouts?
A través de Payouts, puedes enviar múltiples pagos seguros como en una distribución de fondos a empleados, comercios asociados, proveedores o clientes utilizando los fondos que tienes en tu cuenta de PayU.
Solo necesitas proporcionar la cantidad a pagar junto con la información de cada beneficiario (como nombre, identificación, información bancaria, etc.) y PayU transfiere la cantidad solicitada luego de realizar algunas validaciones.
- Solicitud del Payout: envías una solicitud API con la lista de los beneficiarios a los que quieres enviarles los fondos, junto con la cantidad de cada transacción y su información de pago.
- Validación de beneficiarios: los beneficiarios son validados a través de nuestra solución (proceso de Sanction Screening) y se programan los pagos.
- Débito de fondos: el valor de cada Payout junto con la tarifa de procesamiento son debitados de tu cuenta virtual de PayU.
- Confirmación del proceso: el banco procesa el pago de acuerdo con el proceso de ACH. Puedes personalizar las notificaciones para recibir cambios en los estados del pago.
Estados de los Payouts
Los Payouts se ejecutan en dos pasos principales: el primer paso es cuando se solicita el pago al beneficiario y el segundo, es cuando la solicitud ha sido aprobada y pasa a la transferencia de los fondos.
El procedimiento transaccional de Payouts tiene los siguientes estados.
- AWAITING SANCTION SCREENING: este estado indica que el beneficiario a quien se le hará el pago es objeto de validación en listas restrictivas y demás políticas de PayU relacionadas con análisis de riesgo. Si un beneficiario no aprueba esta validación, el pago es rechazado automáticamente.
- AWAITING FOR SENT: si el beneficiario pasa la validación o no es sujeto a ella, este estado indica que la solicitud está lista para ser procesada. En este estado, no se ha realizado la comunicación con servicio.
- SENT TO CREATE: este estado indica que se ha completado la comunicación con el servicio y la solicitud de Payout está en proceso de creación.
- CREATED: este estado indica que se ha creado la solicitud y se ha convertido en una orden de pago. Cuando la solicitud se convierte e una orden de pago, se mueve en los estados explicados en estados de la orden de pago. El siguiente estado depende del resultado del proceso de la orden.
- REJECTED: este estado indica que la solicitud ha sido rechazada. Una solicitud puede ser rechazada cuando:
- Falla la validación del beneficiario.
- Falla la creación del Payout.
- Solicitaste la cancelación del Payout y dicha cancelación fue aprobada.
- PROCESSING COMPLETED: este estado indica que se ha completado el proceso del Payout.
- AWAITING TO CANCEL: este estado indica que has solicitado la cancelación de una solicitud de Payout. Ten en cuenta que puedes solicitar la cancelación de una solicitud de Payout cuando no está en proceso bancario.
En este estado, no se ha realizado la comunicación con servicio. - SENT FOR CANCELLATION: este estado indica que se ha completado la comunicación con el servicio y la solicitud de Payout está en proceso de cancelación.
- CANCELLATION FAILED: este estado indica que la solicitud de cancelación no pudo ser ejecutada debido a políticas de PayU o porque no está siendo procesada por PayU.
El siguiente diagrama ilustra el cambio de estados:
Estados de la orden de pago
Una vez el Payout ha sido aprobado, es transformado en una orden de pago. Los siguientes son los estados de una orden de pago.
- REQUEST_BY_THE_MERCHANT: este es el estado inicial de la transacción, una vez envías la lista de beneficiarios a pagar y son aprobados, la orden toma este estado.
- IN_VALIDATION: debido a políticas de PayU, cada pago puede estar sujeto a una validación. Este estado indica que tu solicitud debe ser revisada bajo nuestras políticas internas. Si la validación falla, el pago que no cumplió con las políticas es rechazado.
- IN_PAYU_PROCESS: este estado indica que PayU ha iniciado el proceso del pago.
- AWAITING_BANK_SENT: este estado indica que PayU ha iniciado la transferencia del monto al beneficiario.
- IN_BANKING_PROCESS: este estado indica que el pago está siendo procesado por la cuenta bancaria del beneficiario. En este punto, no puedes solicitar su cancelación.
- CONFIRMED_BY_THE_BANK: este estado indica que el beneficiario ha recibido el monto de la transferencia.
- REJECTED: este estado indica que la transacción ha sido rechazada por PayU (debido a incumplimiento de políticas) o por el Banco (debido a errores en la información bancaria).
El siguiente diagrama ilustra el cambio de estados:
Validación de la transacción
Cada solicitud de Payout es validada para verificar que la persona que recibirá el dinero no está incluida en listas restrictivas. Esta validación puede tomar hasta 24 horas, lo que podría demorar el pago
Cuando una persona debe ser verificada, PayU verifica primero en el caché de la validación de tal forma que solo sea consultada una vez durante la franja del caché.
Si una persona no aprueba la validación, el Pago no se realiza y se te envía una notificación si tienes configuradas las notificaciones del resultado de la validación.
Consideraciones
Ten en cuentas las siguientes consideraciones:
- Payouts no es un servicio incluido de forma predeterminada. Debes solicitarlo y firmar un anexo al contrato para acordar el valor de la tarifa de procesamiento y demás condiciones. Contacta a tu Key Account Manager para contratar este servicio.
- Los comercios son los responsables de la integridad y la veracidad de la información de los beneficiarios. PayU no valida que la información entregada sea completa y correcta.
PayU no es responsable por transacciones no exitosas debido a información incorrecta. - Payouts solo permite pagos locales. El comercio puede ser internacional (bajo análisis de seguridad y riesgo) pero solo pueden solicitar Payouts utilizando los fondos obtenidos en el país de procesamiento.
Por ejemplo, si el comercio ABC procesa en Colombia y Perú, puede solicitar payouts a beneficiarios en Colombia utilizando los fondos recaudados en Colombia; no pueden solicitar pagos a beneficiarios en Perú utilizando los fondos recaudados en Colombia. - Una vez se ha creado el Payout, toma el flujo regular en PayU. Esto significa que puedes ver el payout creado en el módulo PayU.
- El comercio debe probar la relación entre él y sus beneficiarios para garantizar que la transacción es legítima.
- No se soportan Payouts dirigidos a Daviplata.
Procesamiento de transacciones
Payouts utiliza transferencias ACH (Automated Clearing House) para enviar los pagos a los beneficiarios, esto significa que las transacciones son procesadas por lotes durante el día. El tiempo en el que se procesará la transacción se explica en la siguiente tabla:
Hora del estado IN_BANKING_PROCESS | Hora del proceso de ACH | Hora estimada de respuesta |
---|---|---|
05:31 p.m. - 07:20 a.m. | 9:00 a.m. | 7:55 p.m. |
07:21 a.m. - 09:45 a.m. | 11:30 a.m. | 10:40 a.m. Siguiente día hábil. |
09:46 a.m. - 12:30 p.m. | 2:00 p.m. | 1:45 p.m. Siguiente día hábil. |
12:31 p.m. - 02:50 p.m. | 4:00 p.m. | 4:40 p.m. Siguiente día hábil. |
02:59 p.m. - 04:20 p.m. | 6:00 p.m. | 6:20 p.m. Siguiente día hábil. |
Las transacciones que llegue al estado IN_BANKING_PROCESS después de las 4:20 p.m. serán procesadas el siguiente día hábil.
Nota
Puede que las solicitudes de Payouts no queden en el estado IN_BANKING_PROCESS luego de enviarlas y, dependiendo de la validación de beneficiario, esto puede tomar hasta 24 horas.Notificaciones
Cuando utilizas Payouts, puedes crear un WebHook para configurar notificaciones en los cambios de estado. Se recomienda configurar el WebHook antes de enviar la solicitud de Payout cuando quieras configurar notificaciones.
Puedes configurar un WebHook por uno o varios de los siguientes eventos:
- Creación de la transferencia: envía una notificación cuando se crea la solicitud de payout.
- Actualización de la transferencia: envía una notificación cuando la validación de Sanction Screening rechaza al beneficiario.
- Resultado de la validación: envía una notificación cuando el beneficiario ha aprobado la validación y cuando la transferencia ha sido rechazada por el banco.
Consulta este artículo para aprender a crear WebHooks.
Variables en las notificaciones
Cuando ocurre un evento de los mencionados anteriormente, se envían al WebHook las siguientes variables.
Variable | Formato | Descripción |
---|---|---|
pushPaymentId |
Alfanumérico | Identificador del Payout creado. |
creationDate |
Numérico | Fecha de creación de Payout. Esta fecha está en milisegundos. |
value |
Numérico | Cantidad solicitada para ser transferida al beneficiario. |
currency |
Alfanumérico | Moneda de la cantidad solicitada. |
state |
Alfanumérico | Estado del Payout actual. |
status |
Alfanumérico | Estado de la orden de pago actual. |
errorCode |
Alfanumérico | Error generado luego de la validación de sanction screening. |
errorMessage |
Alfanumérico | Mensaje del error generado luego de la validación de sanction screening. |
supplierBankAccountId |
Alfanumérico | Id de la cuenta bancaria del beneficiario generado por la solicitud de payout. |
fullName |
Alfanumérico | Nombre del beneficiario beneficiario del Payout. |
documentNumber |
Numérico | Número de documento del beneficiario beneficiario del Payout. |
country |
Alfanumérico | País del beneficiario beneficiario del Payout. |
validationState |
Alfanumérico | Resultado de la validación realizada por PayU. |
dateOfTheNextValidation |
Numérico | Fecha en la que el beneficiario será validado por sanction screening. Esta fecha está en milisegundos. |
¿Qué sigue?
La integración con esta funcionalidad se realiza utilizando el API de integraciones.