Saltar al contenido principal
POST
Inicia una transferencia desde una cuenta de Banking Connectivity. transfer_type es obligatorio: OUTGOING para transferencias externas (proporciona los datos bancarios de destination_account), BOOK para transferencias internas entre cuentas del mismo proveedor (define destination_account.account_id con la cuenta de destino) e INCOMING para transferencias entrantes. Los campos obligatorios en destination_account dependen de la región. Consulta Payment rails y Account identifiers by region para más detalles. La respuesta devuelve 202 Accepted con un estado PENDING. Supervisa el progreso mediante Get Entity Transfer Status o eventos de webhook. Consulta Transfer statuses para el ciclo de vida completo de los estados.

Autorizaciones

public-api-key
string
header
requerido
private-secret-key
string
header
requerido

Encabezados

x-idempotency-key
string
requerido

Identificador único que se usa en los encabezados HTTP para asegurar que una solicitud se procese una sola vez, aunque se reintente por problemas de red o tiempos de espera agotados. Consulta autenticación para ver los detalles (UUID).

Cuerpo

application/json
account_id
string
requerido

El identificador único de la cuenta de Yuno del comercio (UUID, 36 caracteres).

Ejemplo:

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

source_account_id
string
requerido

El id de la cuenta de origen de Banking Connectivity obtenido de Create Account (UUID, 36 caracteres).

Ejemplo:

"aa0e8400-e29b-41d4-a716-446655440000"

transfer_type
enum<string>
requerido

El tipo de transferencia. OUTGOING envía fondos a una cuenta externa (define destination_account con los datos bancarios). BOOK mueve fondos a otra cuenta de Banking Connectivity (define destination_account.account_id). INCOMING es una transferencia entrante.

Opciones disponibles:
OUTGOING,
BOOK,
INCOMING
Ejemplo:

"OUTGOING"

amount
object
requerido

El monto de la transferencia. La moneda debe coincidir con la moneda de la cuenta de origen.

payment_rail
enum<string>
requerido

El rail de pago que se usará para la transferencia. Usa BOOK con transfer_type: BOOK. Los rails disponibles dependen de la región del proveedor.

Opciones disponibles:
ACH_STANDARD,
ACH_SAME_DAY,
WIRE,
RTP,
BOOK,
PUSH_TO_CARD
Ejemplo:

"ACH_STANDARD"

description
string

Una descripción de la transferencia.

Ejemplo:

"Payment to vendor"

merchant_transfer_id
string

El ID de referencia propio del comercio para la conciliación.

Ejemplo:

"merchant_txn_12345"

destination_account
object

El destino. Para transferencias OUTGOING, envía los datos bancarios externos; los campos obligatorios dependen de la región: EE. UU. requiere account_number y routing_number; Reino Unido requiere iban o account_number con sort_code; Australia requiere account_number con bsb. Para transferencias BOOK, envía solo account_id con el id de la cuenta de Banking Connectivity de destino.

Respuesta

Aceptado

id
string
Ejemplo:

"bb0e8400-e29b-41d4-a716-446655440000"

source_account_id
string
Ejemplo:

"aa0e8400-e29b-41d4-a716-446655440000"

destination_account_id
any
account_id
string
Ejemplo:

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

merchant_transfer_id
string
Ejemplo:

"merchant_txn_12345"

provider
object
status
string
Ejemplo:

"PENDING"

transfer_type
string
Ejemplo:

"OUTGOING"

destination_account
object
amount
object
payment_rail
string
Ejemplo:

"ACH_STANDARD"

description
string
Ejemplo:

"Payment to vendor"

created_at
string
Ejemplo:

"2026-02-01T10:15:00Z"

updated_at
string
Ejemplo:

"2026-02-01T10:15:00Z"