Beneficios de usar Yuno Payouts
- Centralización: el servicio Payout te ahorra tiempo y costos al centralizar todas tus operaciones de pago en un solo lugar. Ya no necesitas gestionar los pagos en varios sistemas o interfaces.
- Información: mantente informado sobre el estado de los pagos con las notificaciones personalizables de Yuno. Puedes recibir actualizaciones en tiempo real de cualquier cambio en el estado de la orden de pago, según tus preferencias.
- Localización: al depositar los fondos directamente en las cuentas bancarias locales de tus socios, puedes pagarles en su moneda preferida, lo que elimina la necesidad de conversiones de moneda extranjera y les ahorra comisiones e impuestos adicionales.
Cómo funcionan los Payouts
Un payout en Yuno puede pasar por distintos estados, empezando por su creación. Cuando creas un payout, recibe automáticamente el estado CREATED. Sin embargo, el estado CREATED es temporal. A medida que Yuno verifica y transfiere la información al proveedor, el estado del payout cambia a PENDING.
- SUCCEEDED: el proveedor valida la transacción y los fondos se transfieren correctamente a la cuenta del beneficiario. Recibirás una notificación de confirmación.
- REJECTED: el payout no se procesó por problemas que Yuno identificó antes de intentar la transferencia. Entre los posibles motivos de un payout rechazado están fondos insuficientes o datos de payout incorrectos, como un número de cuenta equivocado. Tendrás que crear un nuevo payout para realizar la transacción.
- DECLINED: se intentó el payout, pero el proveedor se negó a aceptarlo. Entre los motivos de un payout rechazado están una cuenta de beneficiario congelada o cerrada, o que la transacción se haya marcado como un posible fraude. Tendrás que crear un nuevo payout para realizar la transacción.
Conceptos nuevos
- Beneficiario (Beneficiary): equivale al cliente en los payins. Es el objeto que recibe la información del beneficiario del payout. Ejemplo: si el payout es para pagos de salarios, el beneficiario sería el empleado que recibe su salario.
- Método de retiro (Withdrawal Method): la contraparte del método de pago para los payouts. Así como los payins requieren información del método de pago, los payouts requieren información del método de retiro. Envía los campos de la categoría que uses: tarjetas, transferencias bancarias o billeteras.
Uso de Yuno Payouts
La función Yuno Payouts está disponible mediante la API de Yuno. Puedes usar la API para crear y consultar la información de los payouts. Para usar la solución Payouts, debes cumplir los siguientes requisitos:- Necesitas una cuenta de Yuno.
- Necesitas integrarte con la API de Yuno.
- Tener una cuenta con un proveedor externo que admita payouts.
- Configura las credenciales del proveedor en la sección Connections de tu dashboard de Yuno.
- (Opcional) Agrega una URL de webhook para recibir notificaciones sobre las actualizaciones de las transacciones de payout.
- Crea el payout con el endpoint Create Payout. Debes enviar la información del beneficiario, el monto y el método de retiro para realizar el payout.
- Yuno verificará la información y luego enviará la solicitud de payout al proveedor. El proveedor analizará los fondos disponibles para autorizar el pago.
- Para consultar el estado actual de los payouts, puedes usar una de las siguientes opciones:
- El endpoint Retrieve Payout by ID, indicando el
idque recibiste al crear el payout. - El endpoint Retrieve Payout by Merchant Reference, indicando el
merchant_referenceque enviaste al crear el payout.
- El endpoint Retrieve Payout by ID, indicando el