Skip to main content
Envía pagos salientes directamente a tus subcuentas desde el saldo de tu plataforma. Las subcuentas deben completar la verificación de identidad y añadir un método de pago saliente antes de poder recibir fondos.
1

Completa la verificación KYC

Antes de que un usuario pueda recibir pagos salientes, debe completar la verificación de identidad (KYC). Usa el flujo alojado de incorporación de cuentas para guiar a los usuarios en este proceso:
Redirige al usuario a la url devuelta en la respuesta. Después de completar la verificación, se le redirigirá de vuelta a tu return_url.
2

Añade un método de pago saliente

Antes de crear un pago saliente, la cuenta necesita un método de pago saliente. Monta el Withdraw element con un token de acceso para la subcuenta. Lista los métodos de pago saliente de la cuenta y recopila uno nuevo cuando no existe ninguno:
Genera el accessToken en tu servidor para la subcuenta, como se muestra en Habilitar pagos salientes de subcuentas. También puedes enviar al usuario al portal de pagos salientes alojado. Para aceptar una cuenta de PayPal solo después de que su titular inicie sesión para demostrar que es suya, conecta un método de pago saliente de PayPal.
3

Obtén el método de pago saliente predeterminado

Lista los métodos de pago saliente de la subcuenta y busca el que tiene is_default: true:
4

Crea un pago saliente

La versión de API 2026-11-03 y posteriores requieren un presupuesto. Primero llama a POST /payouts/quotes con la cuenta, el método de pago saliente, el importe, la moneda y la velocidad que vas a enviar:
Sustituye QUOTE_TOKEN_FROM_RESPONSE en el siguiente ejemplo por el quote_token devuelto y envíalo antes de expires_at. Si una solicitud de pago saliente agota el tiempo de espera, reintenta con la misma Idempotency-Key del pago saliente y el token original. Usa una clave distinta para la solicitud de presupuesto.
En este ejemplo:
  • account_id es la subcuenta a la que se realiza el pago saliente
  • amount es el importe del pago saliente (100,00 USD); las comisiones se descontarán de este importe
  • currency es el código de moneda ISO
  • payout_method_id es el ID del método de pago saliente que se usará (del paso 3)
La solicitud devolverá un error si el importe supera el saldo disponible.

Cubrir las comisiones de pagos salientes de tus subcuentas

De forma predeterminada, las comisiones de pagos salientes se descuentan del saldo de la subcuenta. Puedes optar por cubrir estas comisiones con el saldo de tu plataforma estableciendo platform_covers_fees en true tanto en la solicitud de presupuesto como en la de pago saliente:
Cuando platform_covers_fees es true, la subcuenta recibe el importe completo del pago saliente y la comisión se carga en el saldo de tu plataforma. Esto requiere que la política de cobertura de comisiones de tu plataforma cubra el método de pago saliente, o una clave de API autorizada para gestionar las comisiones de tus subcuentas.

Referencia de la API

API Create Payout

Consulta la referencia completa de la API para crear pagos salientes

Pagar a subcuentas

Transfiere fondos a tus subcuentas

Renderizar el portal de pagos salientes

Permite que tus usuarios retiren sus fondos