Payouts - Colombia

Payouts es una solución API que te permite enviar múltiples pagos de forma fácil y segura a diferentes tipos de beneficiarios (usuarios, comercios, proveedores, clientes, etc.) y se adapta funcionalmente a las especificaciones del mercado de 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.

Concepts

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.

Concepts

  1. 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.
  2. Validación de beneficiarios: los beneficiarios son validados a través de nuestra solución (proceso de Sanction Screening) y se programan los pagos.
  3. Débito de fondos: el valor de cada Payout junto con la tarifa de procesamiento son debitados de tu cuenta virtual de PayU.
  4. 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:

Concepts

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:

Concepts

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.

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.

Última modificación 15 de septiembre de 2023: Payouts - Colombia update (248ce3a31)