Crear onboarding
Inicia un nuevo onboarding para registrar a un destinatario con un proveedor de pago para payouts divididos
Descripción general
El onboarding es el primer paso del flujo de marketplace con pagos divididos. Cada destinatario (submerchant) debe completar el onboarding con los proveedores de pago antes de poder recibir pagos divididos. El proceso de onboarding admite dos flujos:- Cuentas con onboarding previo: para submerchants que ya están registrados con los proveedores. Usa
type: "PREVIOUSLY_ONBOARDED"y envíaprovider.recipient_id, que es obligatorio para este tipo. Consulta Cuentas con onboarding previo. - Onboarding dinámico: para registrar nuevos submerchants, incluida la validación KYC/KYB (Know Your Customer/Know Your Business). Usa
type: "ONE_STEP_ONBOARDING"otype: "TWO_STEP_ONBOARDING"(anteriormentetype: "ONBOARD_ONTO_PROVIDER").
type: "TWO_STEP_ONBOARDING", usa el endpoint Continuar onboarding para completar el proceso KYC después de crear la cuenta.Cuentas con onboarding previo
Usatype: "PREVIOUSLY_ONBOARDED" para asociar una cuenta que el submerchant ya tiene en el proveedor, de modo que Yuno no cree una nueva.
Envía los ids de cuenta del proveedor en el objeto provider, junto con provider.id y provider.connection_id. Yuno reenvía los ids a la integración del proveedor exactamente como se envían:
- La integración admite adoptar cuentas existentes: Yuno registra la cuenta en el proveedor. La respuesta es
201con estadoCREATED, y el onboarding pasa luego a:SUCCEEDEDcuando el proveedor acepta la cuenta. Recibes el webhookonboarding.succeeded.ERRORcuando el proveedor la rechaza, por ejemplo porque el id de cuenta no existe en el proveedor. El mensaje del proveedor está enresponse_messagey recibes el webhookonboarding.error. Para corregirlo, vuelve a registrar la cuenta con los ids correctos.
- Cualquier otro proveedor: el onboarding se registra como
SUCCEEDEDde inmediato y no se hace ninguna llamada al proveedor. Los ids se almacenan tal como se envían y no se validan en el proveedor, así que asegúrate de que sean correctos.
Autorizaciones
Parámetros de ruta
Cuerpo
Tipo de flujo de onboarding. PREVIOUSLY_ONBOARDED asocia una cuenta que ya existe en el proveedor, ONE_STEP_ONBOARDING crea la cuenta y hace el KYC en un solo paso, y TWO_STEP_ONBOARDING primero crea la cuenta y hace el KYC después.
En PREVIOUSLY_ONBOARDED, cuando la integración del proveedor permite adoptar cuentas existentes, Yuno registra la cuenta en el proveedor con los ids de provider: la respuesta es 201 con estado CREATED, y luego el onboarding pasa a SUCCEEDED (webhook onboarding.succeeded) o a ERROR con el mensaje del proveedor en response_message (webhook onboarding.error). Con cualquier otro proveedor, el onboarding se registra como SUCCEEDED de inmediato, no se llama al proveedor y los ids no se validan. Qué proveedores adoptan cuentas existentes es una configuración de Yuno por entorno, no un campo de la API; consulta a tu Key Account Manager.
PREVIOUSLY_ONBOARDED, ONE_STEP_ONBOARDING, TWO_STEP_ONBOARDING "PREVIOUSLY_ONBOARDED"
Respuesta
Creado