Saltar al contenido principal
POST
cURL
Permite a los marketplaces que usan Yuno Split Payments solicitar una transferencia a partir de un pago existente. Solicita una transferencia por un monto determinado a uno de los destinatarios que participan en la división. La transacción debe incluir destinatarios split_marketplace, porque la transferencia se envía a ellos. Si la transacción no tiene ninguno, la API devuelve 400 con “Payment has no recipient”. El monto debe ser menor o igual al monto de la transacción y estar en la moneda del pago.

Autorizaciones

public-api-key
string
header
predeterminado:<Your public-api-key>
requerido
private-secret-key
string
header
predeterminado:<Your private-secret-key>
requerido

Encabezados

X-Idempotency-Key
string

Identificador único que se usa en los encabezados HTTP para garantizar que una solicitud se procese una sola vez, aunque se reintente por problemas de red o timeouts.

Parámetros de ruta

payment_id
string
requerido

El identificador único del pago (MAX 64; MIN 36).

transaction_id
string
requerido

Identificador único de la transacción (MAX 64; MIN 36).

Cuerpo

application/json
amount
object
requerido

El monto del pago (múltiplo de 0.0001).

description
string

Identificador único de la transacción (MAX 256; MIN 3).

Respuesta

Creado

id
string

Identificador único de la transferencia.

recipient_id
string

El identificador único del destinatario.

amount
object
status
string

Estado de la transferencia.

description
string
merchant_reference
string
metadata
any[]
provider
object | null
transactions
object[]
created_at
string<date-time>
updated_at
string<date-time>
completed_at
string<date-time>