Saltar al contenido principal
POST
Create Standalone Transfer
Crea una transferencia de forma independiente de un pago. El campo direction determina qué cuenta envía los fondos.
Las transferencias del destinatario a la plataforma no están disponibles de forma general. Usa esta dirección solo después de que Yuno confirme la habilitación de la cuenta y la compatibilidad del proveedor.
La dirección se guarda al crear la transferencia y se devuelve en la respuesta, en GET y en las notificaciones de la transferencia. No se puede cambiar después de la creación. Reutilizar la misma cuenta y la misma clave de idempotencia con una dirección distinta se rechaza; omitir la dirección y enviar PLATFORM_TO_RECIPIENT de forma explícita representan la misma dirección. Las cadenas no válidas (incluidos los valores vacíos o con mayúsculas y minúsculas incorrectas), los objetos, los arreglos, los números y los booleanos devuelven 400 INVALID_PARAMETERS. Una solicitud de destinatario a plataforma con un proveedor distinto de STRIPE devuelve 400 INVALID_PARAMETERS antes de la verificación de habilitación. Una solicitud válida de destinatario a plataforma para una cuenta sin acceso devuelve 400 DIRECTION_NOT_ENABLED, antes de la verificación de dirección de idempotencia. Una transferencia de destinatario a plataforma no se puede revertir. Para devolver una comisión cobrada por separado, crea una nueva transferencia de plataforma a destinatario.

Autorizaciones

PUBLIC-API-KEY
string
header
requerido
PRIVATE-SECRET-KEY
string
header
requerido

Encabezados

X-Account-Code
string<uuid>
requerido

El account_id que se encuentra en el Dashboard de Yuno. La API lee la cuenta de este encabezado.

X-Idempotency-Key
string
requerido

Clave única para la idempotencia de la solicitud.

Cuerpo

application/json
recipient_id
string<uuid>
requerido

El identificador del destinatario objetivo. El destinatario debe tener un onboarding para provider_id en estado PENDING o SUCCEEDED.

provider_id
string
requerido

El código del proveedor de pago que se usará (por ejemplo, adyen, stripe).

amount
object
requerido
account_id
string
obsoleto

No se usa. La API toma la cuenta del encabezado X-Account-Code, por lo que puedes omitir este campo.

description
string

Una descripción legible de la transferencia (3-255 caracteres). Se envía al proveedor.

merchant_reference
string

Identificador único del comercio para la idempotencia y el seguimiento.

metadata
object[]
direction
enum<string> | null
predeterminado:PLATFORM_TO_RECIPIENT

Dirección de la transferencia. Si se omite o es null, el valor por defecto es PLATFORM_TO_RECIPIENT. RECIPIENT_TO_PLATFORM solo se admite para cuentas STRIPE elegibles. RECIPIENT_TO_PLATFORM no está disponible de forma general. Úsalo solo después de que Yuno confirme la habilitación de la cuenta y la compatibilidad del proveedor.

Opciones disponibles:
PLATFORM_TO_RECIPIENT,
RECIPIENT_TO_PLATFORM,
null

Respuesta

Creado

id
string
Ejemplo:

"TRF_7kB2mQ9xPnL4vR"

direction
enum<string>

La dirección inmutable guardada cuando se creó la transferencia. Las transferencias existentes devuelven PLATFORM_TO_RECIPIENT. No se puede cambiar después de la creación.

Opciones disponibles:
PLATFORM_TO_RECIPIENT,
RECIPIENT_TO_PLATFORM
Ejemplo:

"PLATFORM_TO_RECIPIENT"

recipient_id
string<uuid>
Ejemplo:

"550e8400-e29b-41d4-a716-446655440000"

amount
object
status
string
Ejemplo:

"SUCCEEDED"

reason
string
Ejemplo:

"ORDER_CANCELLED"

description
string
Ejemplo:

"Weekly marketplace earnings"

merchant_reference
string
Ejemplo:

"TRANSFER-2026-02-15-001"

metadata
object[]
provider_data
object
created_at
string<date-time>
Ejemplo:

"2026-02-16T10:30:00Z"

updated_at
string<date-time>
Ejemplo:

"2026-02-16T10:30:15Z"

completed_at
string<date-time>
Ejemplo:

"2026-02-16T10:30:15Z"

provider
string | null
Ejemplo:

null

transactions
object[]