Saltar al contenido principal
POST
Crea un nuevo destinatario para escenarios de pago dividido. Este endpoint permite a los comercios definir destinatarios que pueden recibir porciones de los pagos en modelos de marketplace o de pago dividido.

Autorizaciones

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

Cuerpo

application/json
account_id
string
requerido

ID único de la cuenta en Yuno (MAX 64; MIN 36).

Ejemplo:

"9104911d-5df9-429e-8488-ad41abea1a4b"

merchant_recipient_id
string
requerido

Identificador único del destinatario definido por el comercio (MAX 255; MIN 1).

Ejemplo:

"AAAA01"

national_entity
enum<string>
requerido

Tipo de entidad nacional del beneficiario. Puede ser INDIVIDUAL o ENTITY.

Opciones disponibles:
INDIVIDUAL,
ENTITY
Ejemplo:

"INDIVIDUAL"

first_name
string
requerido

Nombre del beneficiario. (MAX 80; MIN 1).

Ejemplo:

"John"

last_name
string
requerido

Apellido del beneficiario. (MAX 80; MIN 1).

Ejemplo:

"Doe"

country
string
requerido

País del beneficiario (ISO 3166-1 MAX 2; MIN 2).

Ejemplo:

"CO"

entity_type
enum<string>

Tipo de organización del beneficiario. GOVERNMENTAL, PUBLIC, NON_PROFIT, PRIVATE

Opciones disponibles:
GOVERNMENTAL,
PUBLIC,
NON_PROFIT,
PRIVATE
Ejemplo:

"PRIVATE"

date_of_birth
string

Fecha de nacimiento del beneficiario en formato YYYY-MM-DD (MAX 10; MIN 10).

Required string length: 10
Ejemplo:

"1990-02-28"

Nombre del beneficiario. (MAX 80; MIN 1) Solo es necesario cuando la entidad nacional es ENTITY.

Ejemplo:

"Arcos dorados S.A."

email
string

Email del beneficiario (MAX 255; MIN 3).

Ejemplo:

"john.doe@email.com"

website
string

La URL del sitio web del vendedor (MAX 255; MIN 3).

Required string length: 3 - 255
Ejemplo:

"https://y.uno"

industry
string

Industria del vendedor (MAX 235; MIN 1). Para más información, accede a la página de referencia de categorías de industria.

Required string length: 1 - 235
Ejemplo:

"VIRTUAL_GOODS"

merchant_category_code
string

MCC: el código de categoría del comercio (MAX 235; MIN 1).

document
object

Información del documento del beneficiario

phone
object

Indica el objeto del número de teléfono del cliente.

address
object

Dirección

split_configuration
object

Reglas para el cálculo automático de la división a nivel de destinatario.

Propietarios o beneficiarios del destinatario. Obligatorio cuando national_entity = ENTITY.

withdrawal_methods
object

Métodos de retiro del comercio

documentation
object[]

Arreglo de objetos de documentación

onboardings
object[]

Arreglo de objetos de onboarding para distintos proveedores de pago

Respuesta

Destinatario creado correctamente

id
string

El identificador único del destinatario.

Ejemplo:

"3aaa4d82-11e8-48ce-8ef5-04eee3a10802"

account_id
string

El identificador de cuenta asociado a este destinatario.

Ejemplo:

"fe14c7c6-c75e-43b7-bdbe-4c87ad52c482"

merchant_recipient_id
string

Identificador único del destinatario definido por el comercio.

Ejemplo:

"MERCHANT_182acf1d-faeb-4ff0-94cd-7fab11b282f6"

national_entity
string

Tipo de entidad nacional del beneficiario.

Ejemplo:

"INDIVIDUAL"

entity_type
string

Tipo de organización del beneficiario.

Ejemplo:

"PRIVATE"

first_name
string

Nombre del beneficiario.

Ejemplo:

"Juan"

last_name
string

Apellido del beneficiario.

Ejemplo:

"Perez"

Razón social del beneficiario.

Ejemplo:

null

email
string

El correo electrónico del beneficiario.

Ejemplo:

"juan.perez@example.com"

date_of_birth
string

Fecha de nacimiento del beneficiario.

Ejemplo:

"1990-01-15"

country
string

El país del beneficiario.

Ejemplo:

"CO"

website
string

La URL del sitio web del vendedor.

Ejemplo:

"https://juanperez.com"

industry
string

El sector del vendedor.

Ejemplo:

"Technology"

merchant_category_code
string

El código de categoría del comercio (MCC) (MAX 235; MIN 1).

Ejemplo:

"5734"

document
object
phone
object
address
object
withdrawal_methods
object
documentation
object[]
onboardings
object[]
split_configuration
object[] | null

Reglas para el cálculo automático del split a nivel de destinatario. Se devuelve como un arreglo que contiene la regla de split actual, aunque las solicitudes envían split_configuration como un objeto. null cuando no hay configuración de split.

created_at
string<date-time>

Fecha de creación del destinatario (ISO 8601 MAX 27; MIN 27).

Ejemplo:

"2025-08-27T15:41:19.497413Z"

updated_at
string<date-time>

Fecha de la última actualización del destinatario (ISO 8601 MAX 27; MIN 27).

Ejemplo:

"2025-08-27T15:41:19.497425Z"