Saltar al contenido principal
POST
Continuar onboarding
Continúa el proceso de onboarding de un destinatario. Este endpoint se usa en los flujos de onboarding de dos pasos para ejecutar el paso de KYC después de crear la cuenta. Este endpoint continúa el proceso de onboarding de un destinatario y ejecuta específicamente el paso de KYC (Know Your Customer) en los flujos de onboarding de dos pasos. Úsalo cuando necesites completar la validación de KYC después de que la creación de la cuenta se haya completado mediante Create Onboarding.

Requisitos previos

Este endpoint requiere una llamada previa a Create Onboarding con type: "TWO_STEP_ONBOARDING", en la que el paso de creación de la cuenta se haya completado correctamente. Este es el segundo paso en los flujos de onboarding de dos pasos para el marketplace de pagos divididos. El proceso de continuación admite dos tipos de flujo de trabajo:
  • HOSTED_BY_PROVIDER: devuelve una URL de redirección de Yuno que registra la actividad y redirige a la interfaz de KYC del proveedor. Usa workflow: "HOSTED_BY_PROVIDER".
  • DIRECT: procesa la validación de KYC directamente, sin redirecciones externas. Usa workflow: "DIRECT".

Envío de una cuenta bancaria

Para un destinatario existente de un proveedor Zoop o Pagar.me, un withdrawal_methods.bank explícito se confirma mediante la ruta de actualización bancaria antes de continuar con el KYC. Esto incluye la primera cuenta bancaria de un vendedor existente. Después de que el proveedor confirma el banco, Yuno lo guarda para el onboarding seleccionado y continúa con el KYC sin volver a enviar el banco. El valor predeterminado del destinatario no cambia. Una actualización bancaria exitosa no significa que el KYC esté completo: el onboarding aún puede requerir documentos de identidad u otra información. Un rechazo definitivo del banco devuelve 400; un resultado sin confirmar devuelve 409. En cualquiera de los dos casos, esa solicitud no inicia el KYC y el banco sin confirmar no se guarda. Sigue la guía de errores bancarios y reintentos antes de reintentar. Si el banco se confirma pero un paso posterior del KYC falla, el cambio bancario no se revierte. Otros proveedores y el onboarding inicial sin un ID de destinatario del proveedor mantienen su comportamiento de continuación existente.

Autorizaciones

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

Parámetros de ruta

recipient_id
string
requerido

ID del destinatario

onboarding_id
string
requerido

ID del onboarding que se va a continuar

Cuerpo

application/json
account_id
string
requerido

ID único de la cuenta en Yuno

Ejemplo:

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

type
enum<string>
requerido

Tipo de flujo de onboarding. Solo se puede continuar TWO_STEP_ONBOARDING.

Opciones disponibles:
TWO_STEP_ONBOARDING
Ejemplo:

"TWO_STEP_ONBOARDING"

workflow
enum<string>
requerido

Flujo del proceso de KYC. HOSTED_BY_PROVIDER llama al servicio de creación de KYC y devuelve una URL de Yuno que redirige al proveedor. DIRECT llama al servicio de creación de KYC y procesa el KYC directamente.

Opciones disponibles:
HOSTED_BY_PROVIDER,
DIRECT
Ejemplo:

"HOSTED_BY_PROVIDER"

callback_url
string<uri>

URL a la que redirigir a tu cliente después del proceso de onboarding con el proveedor, si es necesario.

Ejemplo:

"https://www.google.com"

provider
object
documentation
object[]

Especifica el objeto de documentación.

withdrawal_methods
object

Especifica el objeto de métodos de retiro.

Objeto que indica los propietarios de la organización. Adyen, Stripe y dlocal tienen campos relacionados con esto.

terms_of_service
object

Objeto que describe los términos de servicio.

Respuesta

Creado

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

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

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"