Este objeto representa a un destinatario que recibirá parte de un pago fraccionado. Representa la cuenta de un vendedor dentro de tu marketplace. El split te permite dispersar el dinero de una compra en tu marketplace directamente a la cuenta del vendedor mientras que tu comisión va a tu cuenta de marketplace.
Atributos
id string
Identificador único del destinatario (MAX 64 ; MIN 36).
Example: 9104911d-5df9-429e-8488-ad41abea1a4b.
account_id string
El identificador único de la cuenta (MÁX 64; MÍN 36).
Ejemplo: 4323f8a0-7699-4a5b-8293-f4d712312eb3bd.
merchant_recipient_id string
Identificador único del destinatario para el propietario del mercado (MAX 255; MIN 3).
Ejemplo: AAAA01.
national_entity string
Categoría de entidad nacional del beneficiario. Puede ser individual o entidad.
Ejemplo: INDIVIDUAL.
entity_type string
Tipo de entidad nacional del beneficiario. Puede ser pública, gubernamental, sin ánimo de lucro o privada.
Ejemplo: PRIVADO.
first_name string
Nombre del destinatario (MAX 255; MIN 3).
Ejemplo: Juan.
last_name string
Apellido del destinatario (MAX 255; MIN 3).
Ejemplo: Doe.
legal_name string
Nombre del beneficiario. (Máx: 80) Sólo es necesario cuando la entidad nacional es ENTIDAD (MÁX 64 ; MÍN 36).
Ejemplo: Arcos dorados SA
email string
Correo electrónico del destinatario (MAX 255; MIN 3).
Ejemplo: [email protected].
date_of_birth string
La fecha de nacimiento del destinatario en formato AAAA-MM-DD (MÁX 10; MÍN 10).
Ejemplo: 1990-02-28.
country enum
País del destinatario (MAX 2; MIN 2.) ISO 3166-1).
Posibles valores del enum: Compruebe la lista de códigos de país.
website string
La URL del sitio web del destinatario (MÁX. 255; MÍN. 3).
Ejemplo: https://www.my-site.com
industry string
Industria del destinatario (MÁX 235; MÍN 1) Para obtener más información acceda a la página de referencia de la categoría Industria.
Ejemplo: VIRTUAL_GOODS
merchant_category_code string
El código de categoría del comerciante (MÁX 235; MÍN 1).
Ejemplo: TTR
document objeto
Especifica el objeto documento del destinatario, incluyendo su número y tipo.
document_number string
El número de documento del destinatario (MAX 40; MIN 3).
Ejemplo: 1093333333.
document_type enum
Tipo de documento del destinatario (MAX 6, MIN 2).
Posibles valores del enum: Comprueba la Referencia de país.
phone objeto
Especifica el objeto número de teléfono del destinatario.
country_code string
El código de país del teléfono del destinatario (MAX 3; MIN 2).
Ejemplo: 57.
number string
El número de teléfono del destinatario, sin el prefijo del país (MAX 32; MIN 1).
Ejemplo: 3132450765.
address objeto
Especifica el objeto de dirección de facturación del destinatario.
address_line_1 string
Línea de la dirección de facturación principal del destinatario (MAX 255; MIN 3).
Ejemplo: Calle 34 # 56 - 78.
address_line_2 string
La línea de dirección de facturación secundaria del destinatario (MAX 255; MIN 3).
Ejemplo: Apartamento 502, Torre I.
city string
La ciudad considerada para la dirección de facturación (MÁX 255; MÍN 3).
Ejemplo: Bogotá.
country enum
El país considerado para la dirección de facturación (MÁX 2; MÍN 2; ISO 3166-1).
Posibles valores del enum: Compruebe la lista de códigos de país.
state string
El estado considerado para la dirección de facturación (MÁX 255; MÍN 3).
Ejemplo: Cundinamarca.
zip_code string
El código postal considerado para la dirección de facturación (MÁX 11; MÍN 4).
Ejemplo: 111111.
withdrawal_methods array de objects
Una lista de objetos de métodos de retiro; cada elemento contiene un objeto bancario
bank struct
Datos bancarios para este método de retiro.
code string
Código del banco (MAX 3; MIN 3).
Ejemplo: 246
branch string
Sucursal bancaria (MAX 3; MIN 3).
Ejemplo: 123
branch_digit string
Dígito de sucursal del banco (MAX 1; MIN 1).
Ejemplo: 5
account string
Número de cuenta bancaria del beneficiario (MÁX 250; MÍN 3).
Ejemplo: 1093333333
account_digit string
Dígito de la cuenta bancaria del beneficiario (MÁX 1; MÍN 1).
Ejemplo: 7
account_type enum
Tipo de cuenta bancaria del beneficiario: CHECKINGS o SAVINGS.
Ejemplo: AHORROS
routing string
Número de ruta de la cuenta bancaria del beneficiario.
Ejemplo: 021000021
country string
País de la cuenta bancaria (ISO 3166-1 alpha-2).
Ejemplo: CO
currency string
La moneda de la cuenta bancaria (ISO 4217).
Ejemplo: COP
documentation array de objects
Un conjunto de objetos de documentación proporcionados por el comerciante.
file_name string
Nombre de la documentación enviada (MAX 255; MIN 3).
Ejemplo: recibo.pdf
Ejemplo: recibo.pdf
content_type enum
Tipo de documentación enviada por el comerciante.
Ejemplo: RECEPCIÓN
Ejemplo: RECEPCIÓN
content_category string
La categoría de la documentación enviada por el comerciante (por ejemplo, FACTURA, ID_PRUEBA).
content string
El contenido de la documentación codificado en base64 (Tamaño máximo: 1MB).
Ejemplo:JVBERi0xLjQKJcfs...
Ejemplo:JVBERi0xLjQKJcfs...
onboardings array de objects
Lista de registros de incorporación para cada conexión de proveedor.
id enum
El identificador único de la incorporación.
Ejemplo: 9104911d-5df9-429e-8488-ad41abea1a4b
type enum
Tipo de incorporación. Si se realizó previamente o a través de Yuno.
ANTERIORMENTE INCORPORADO, INCORPORADO AL PROVEEDOR
workflow enum
Flujo de trabajo del onboarding.
ALOJADO POR EL PROVEEDOR, ALOJADO POR YUNO, DIRECTO
status enum
Estado de la vinculación con el comerciante.
PENDIENTE, EXITOSO, RECHAZADO, BLOQUEADO, CANCELADO, RECHAZADO, ERROR
provider_response_code string
Código de respuesta devuelto por el proveedor durante onboarding.
Ejemplo: 00
provider_response_message string
Mensaje descriptivo del proveedor asociado con la onboarding .
Ejemplo: Aprobado
provider_raw_response string
Referencia a la respuesta completa del proveedor sin procesar. Utiliza este identificador para recuperar la carga útil completa cuando sea necesario.
Ejemplo: 64b3f8cba12e3c7d9f0a1234
callback_url string
URL para redirigir a tu cliente después del proceso de incorporación, si es necesario.
Ejemplo: https://www.google.com
provider objeto
Información sobre la conexión del proveedor de pagos.
id string
Identificador del proveedor.
Ejemplo: ADYEN
connection_id string
El identificador de conexión específico de Yuno asociado a esa onboarding.
Ejemplo: 322d48b6-f423-4438-8ffb-0b9b5059a2e9
recipient_id string
El identificador único del destinatario del proveedor.
Ejemplo: 9104911d-5df9-429e-8488-ad41abea1a4b
redirect_url string
URL de redirección a la que se redirigirá al usuario final una vez finalizado el onboarding .
Ejemplo: https://www.example.com/callback
onboarding_url string
URL para redirigir a su destinatario para finalizar la incorporación.
Ejemplo: https:onboarding
legal_entity string
El identificador de entidad jurídica asociado al proveedor.
recipient_additional_id string
Información adicional sobre el destinatario. Normalmente el ID de la entidad jurídica.
balance_account_id string
El identificador único de la cuenta de saldo del proveedor.
documentation array de objects
Un conjunto de objetos de documentación proporcionados por el comerciante.
file_name string
El nombre de la documentación enviada (MAX 255; MIN 3).
Ejemplo: recibo.pdf
content_type enum
El tipo de documentación enviada por el comerciante.
Ejemplo: RECIBO
content_category string
La categoría de la documentación enviada por el comerciante.
content string
El contenido de la documentación codificado en base64 (tamaño máximo: 1 MB).
Ejemplo: JVBERi0xLjQKJcfs…
withdrawal_methods array de objects
Una lista de objetos de método de retirada; cada uno contiene un bank estructura.
bank estructura.
bank struct
Datos bancarios para este método de retiro.
code string
Código del banco (MAX 3; MIN 3).
Ejemplo: 246
branch string
Sucursal bancaria (MAX 3; MIN 3).
Ejemplo: 123
branch_digit string
Dígito de sucursal del banco (MAX 3; MIN 3).
Ejemplo: 5
account string
Número de cuenta bancaria del beneficiario (MÁX 250; MÍN 3).
Ejemplo: 1093333333
account_digit string
Dígito de la cuenta bancaria del beneficiario (MÁX 250; MÍN 1).
Ejemplo: 7
account_type enum
Tipo de cuenta bancaria del beneficiario: CHECKINGS, SAVINGS
Ejemplo: AHORROS
created_at marca de tiempo
Fecha de creación de la incorporación (ISO 8601).
Ejemplo: 2022-05-09T20:46:54.786342Z
updated_at marca de tiempo
Fecha de última actualización de incorporación (ISO 8601).
Ejemplo: 2022-07-09T20:43:54.786342Z
created_at marca de tiempo
Fecha y hora de creación del destinatario (MAX 27; MIN 27; ISO 8601).
Ejemplo: 2022-05-09T20:46:54.786342Z.
updated_at marca de tiempo
Fecha y hora de la última actualización del destinatario (MAX 27; MIN 27; ISO 8601).
Ejemplo: 2022-05-09T20:46:54.786342Z.