Recipients for Marketplace
Continue Onboarding
Resume a recipient’s onboarding after providing additional required data or documentation
POST
/
recipients
/
{recipient_id}
/
onboardings
/
{onboarding_id}
/
continue
Continue Onboarding
curl --request POST \
--url https://api-sandbox.y.uno/v1/recipients/{recipient_id}/onboardings/{onboarding_id}/continue \
--header 'Content-Type: application/json' \
--header 'private-secret-key: <api-key>' \
--header 'public-api-key: <api-key>' \
--data '
{
"account_id": "9104911d-5df9-429e-8488-ad41abea1a4b",
"type": "TWO_STEP_ONBOARDING",
"workflow": "HOSTED_BY_PROVIDER",
"callback_url": "https://www.google.com",
"provider": {
"id": "PAGARME",
"connection_id": "104911d-5df9-429e-8488-ad41abea1a4b",
"recipient_id": "AAAAA01"
},
"documentation": [
{
"file_name": "PDF",
"content_type": "application/pdf",
"content": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCg=="
}
],
"withdrawal_methods": {
"bank": {
"code": "246",
"branch": "XXXX",
"branch_digit": "<string>",
"account": "1093333333",
"account_digit": "<string>",
"account_type": "SAVINGS",
"routing": "XXXXYYYYC",
"country": "CO",
"currency": "COP"
}
},
"legal_representatives": [
{
"merchant_reference": "<string>",
"first_name": "John",
"last_name": "Doe",
"email": "john.doe@email.com",
"date_of_birth": "1990-02-28",
"country": "CO",
"nationality": "CO",
"title": "CTO",
"publicly_exposed_person": false,
"ultimate_beneficial_owner": false
}
]
}
'import requests
url = "https://api-sandbox.y.uno/v1/recipients/{recipient_id}/onboardings/{onboarding_id}/continue"
payload = {
"account_id": "9104911d-5df9-429e-8488-ad41abea1a4b",
"type": "TWO_STEP_ONBOARDING",
"workflow": "HOSTED_BY_PROVIDER",
"callback_url": "https://www.google.com",
"provider": {
"id": "PAGARME",
"connection_id": "104911d-5df9-429e-8488-ad41abea1a4b",
"recipient_id": "AAAAA01"
},
"documentation": [
{
"file_name": "PDF",
"content_type": "application/pdf",
"content": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCg=="
}
],
"withdrawal_methods": { "bank": {
"code": "246",
"branch": "XXXX",
"branch_digit": "<string>",
"account": "1093333333",
"account_digit": "<string>",
"account_type": "SAVINGS",
"routing": "XXXXYYYYC",
"country": "CO",
"currency": "COP"
} },
"legal_representatives": [
{
"merchant_reference": "<string>",
"first_name": "John",
"last_name": "Doe",
"email": "john.doe@email.com",
"date_of_birth": "1990-02-28",
"country": "CO",
"nationality": "CO",
"title": "CTO",
"publicly_exposed_person": False,
"ultimate_beneficial_owner": False
}
]
}
headers = {
"public-api-key": "<api-key>",
"private-secret-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'public-api-key': '<api-key>',
'private-secret-key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
account_id: '9104911d-5df9-429e-8488-ad41abea1a4b',
type: 'TWO_STEP_ONBOARDING',
workflow: 'HOSTED_BY_PROVIDER',
callback_url: 'https://www.google.com',
provider: {
id: 'PAGARME',
connection_id: '104911d-5df9-429e-8488-ad41abea1a4b',
recipient_id: 'AAAAA01'
},
documentation: [
{
file_name: 'PDF',
content_type: 'application/pdf',
content: 'JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCg=='
}
],
withdrawal_methods: {
bank: {
code: '246',
branch: 'XXXX',
branch_digit: '<string>',
account: '1093333333',
account_digit: '<string>',
account_type: 'SAVINGS',
routing: 'XXXXYYYYC',
country: 'CO',
currency: 'COP'
}
},
legal_representatives: [
{
merchant_reference: '<string>',
first_name: 'John',
last_name: 'Doe',
email: 'john.doe@email.com',
date_of_birth: '1990-02-28',
country: 'CO',
nationality: 'CO',
title: 'CTO',
publicly_exposed_person: false,
ultimate_beneficial_owner: false
}
]
})
};
fetch('https://api-sandbox.y.uno/v1/recipients/{recipient_id}/onboardings/{onboarding_id}/continue', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api-sandbox.y.uno/v1/recipients/{recipient_id}/onboardings/{onboarding_id}/continue",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'account_id' => '9104911d-5df9-429e-8488-ad41abea1a4b',
'type' => 'TWO_STEP_ONBOARDING',
'workflow' => 'HOSTED_BY_PROVIDER',
'callback_url' => 'https://www.google.com',
'provider' => [
'id' => 'PAGARME',
'connection_id' => '104911d-5df9-429e-8488-ad41abea1a4b',
'recipient_id' => 'AAAAA01'
],
'documentation' => [
[
'file_name' => 'PDF',
'content_type' => 'application/pdf',
'content' => 'JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCg=='
]
],
'withdrawal_methods' => [
'bank' => [
'code' => '246',
'branch' => 'XXXX',
'branch_digit' => '<string>',
'account' => '1093333333',
'account_digit' => '<string>',
'account_type' => 'SAVINGS',
'routing' => 'XXXXYYYYC',
'country' => 'CO',
'currency' => 'COP'
]
],
'legal_representatives' => [
[
'merchant_reference' => '<string>',
'first_name' => 'John',
'last_name' => 'Doe',
'email' => 'john.doe@email.com',
'date_of_birth' => '1990-02-28',
'country' => 'CO',
'nationality' => 'CO',
'title' => 'CTO',
'publicly_exposed_person' => false,
'ultimate_beneficial_owner' => false
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"private-secret-key: <api-key>",
"public-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api-sandbox.y.uno/v1/recipients/{recipient_id}/onboardings/{onboarding_id}/continue"
payload := strings.NewReader("{\n \"account_id\": \"9104911d-5df9-429e-8488-ad41abea1a4b\",\n \"type\": \"TWO_STEP_ONBOARDING\",\n \"workflow\": \"HOSTED_BY_PROVIDER\",\n \"callback_url\": \"https://www.google.com\",\n \"provider\": {\n \"id\": \"PAGARME\",\n \"connection_id\": \"104911d-5df9-429e-8488-ad41abea1a4b\",\n \"recipient_id\": \"AAAAA01\"\n },\n \"documentation\": [\n {\n \"file_name\": \"PDF\",\n \"content_type\": \"application/pdf\",\n \"content\": \"JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCg==\"\n }\n ],\n \"withdrawal_methods\": {\n \"bank\": {\n \"code\": \"246\",\n \"branch\": \"XXXX\",\n \"branch_digit\": \"<string>\",\n \"account\": \"1093333333\",\n \"account_digit\": \"<string>\",\n \"account_type\": \"SAVINGS\",\n \"routing\": \"XXXXYYYYC\",\n \"country\": \"CO\",\n \"currency\": \"COP\"\n }\n },\n \"legal_representatives\": [\n {\n \"merchant_reference\": \"<string>\",\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"email\": \"john.doe@email.com\",\n \"date_of_birth\": \"1990-02-28\",\n \"country\": \"CO\",\n \"nationality\": \"CO\",\n \"title\": \"CTO\",\n \"publicly_exposed_person\": false,\n \"ultimate_beneficial_owner\": false\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("public-api-key", "<api-key>")
req.Header.Add("private-secret-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api-sandbox.y.uno/v1/recipients/{recipient_id}/onboardings/{onboarding_id}/continue")
.header("public-api-key", "<api-key>")
.header("private-secret-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"account_id\": \"9104911d-5df9-429e-8488-ad41abea1a4b\",\n \"type\": \"TWO_STEP_ONBOARDING\",\n \"workflow\": \"HOSTED_BY_PROVIDER\",\n \"callback_url\": \"https://www.google.com\",\n \"provider\": {\n \"id\": \"PAGARME\",\n \"connection_id\": \"104911d-5df9-429e-8488-ad41abea1a4b\",\n \"recipient_id\": \"AAAAA01\"\n },\n \"documentation\": [\n {\n \"file_name\": \"PDF\",\n \"content_type\": \"application/pdf\",\n \"content\": \"JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCg==\"\n }\n ],\n \"withdrawal_methods\": {\n \"bank\": {\n \"code\": \"246\",\n \"branch\": \"XXXX\",\n \"branch_digit\": \"<string>\",\n \"account\": \"1093333333\",\n \"account_digit\": \"<string>\",\n \"account_type\": \"SAVINGS\",\n \"routing\": \"XXXXYYYYC\",\n \"country\": \"CO\",\n \"currency\": \"COP\"\n }\n },\n \"legal_representatives\": [\n {\n \"merchant_reference\": \"<string>\",\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"email\": \"john.doe@email.com\",\n \"date_of_birth\": \"1990-02-28\",\n \"country\": \"CO\",\n \"nationality\": \"CO\",\n \"title\": \"CTO\",\n \"publicly_exposed_person\": false,\n \"ultimate_beneficial_owner\": false\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-sandbox.y.uno/v1/recipients/{recipient_id}/onboardings/{onboarding_id}/continue")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["public-api-key"] = '<api-key>'
request["private-secret-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"account_id\": \"9104911d-5df9-429e-8488-ad41abea1a4b\",\n \"type\": \"TWO_STEP_ONBOARDING\",\n \"workflow\": \"HOSTED_BY_PROVIDER\",\n \"callback_url\": \"https://www.google.com\",\n \"provider\": {\n \"id\": \"PAGARME\",\n \"connection_id\": \"104911d-5df9-429e-8488-ad41abea1a4b\",\n \"recipient_id\": \"AAAAA01\"\n },\n \"documentation\": [\n {\n \"file_name\": \"PDF\",\n \"content_type\": \"application/pdf\",\n \"content\": \"JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCg==\"\n }\n ],\n \"withdrawal_methods\": {\n \"bank\": {\n \"code\": \"246\",\n \"branch\": \"XXXX\",\n \"branch_digit\": \"<string>\",\n \"account\": \"1093333333\",\n \"account_digit\": \"<string>\",\n \"account_type\": \"SAVINGS\",\n \"routing\": \"XXXXYYYYC\",\n \"country\": \"CO\",\n \"currency\": \"COP\"\n }\n },\n \"legal_representatives\": [\n {\n \"merchant_reference\": \"<string>\",\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"email\": \"john.doe@email.com\",\n \"date_of_birth\": \"1990-02-28\",\n \"country\": \"CO\",\n \"nationality\": \"CO\",\n \"title\": \"CTO\",\n \"publicly_exposed_person\": false,\n \"ultimate_beneficial_owner\": false\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"id": "61df26d9-3750-4206-baab-f2e20683f35b",
"type": "TWO_STEP_ONBOARDING",
"workflow": "HOSTED_BY_PROVIDER",
"status": "PENDING",
"provider": {
"id": "STRIPE",
"connection_id": "8fee3cc6-f3cb-455d-b139-973866111a03",
"recipient_id": "acct_1RvpogA4Jk50vKRE",
"redirect_url": "https://api.y.uno/redirect/kyc/stripe/session_12345"
},
"created_at": "2025-08-22T17:57:58.460711Z",
"updated_at": "2025-08-22T18:15:22.123456Z"
}{
"code": "INVALID_REQUEST",
"messages": [
"Invalid request format"
]
}{
"code": "INVALID_CREDENTIALS",
"messages": [
"Invalid credentials"
]
}{
"code": "AUTHORIZATION_REQUIRED",
"messages": [
"The merchant has no authorization to use this API."
]
}Continues the onboarding process for a recipient. This endpoint is used for two-step onboarding flows to execute the KYC step after account creation.
This endpoint continues the onboarding process for a recipient, specifically executing the KYC (Know Your Customer) step in two-step onboarding flows. Use this when you need to complete KYC validation after account creation has been completed via Create Onboarding.
Prerequisites
This endpoint requires a prior Create Onboarding call withtype: "TWO_STEP_ONBOARDING" where the account creation step has been completed successfully. This is the second step in two-step onboarding flows for the split payments marketplace.
The continue process supports two workflow types:
- HOSTED_BY_PROVIDER: Returns a Yuno redirect URL that logs activity and redirects to the provider’s KYC interface. Use
workflow: "HOSTED_BY_PROVIDER". - DIRECT: Processes KYC validation directly without external redirects. Use
workflow: "DIRECT".
Authorizations
Path Parameters
ID of the recipient
ID of the onboarding to continue
Body
application/json
Unique id of the account in Yuno
Example:
"9104911d-5df9-429e-8488-ad41abea1a4b"
Type of onboarding flow. Only TWO_STEP_ONBOARDING can be continued.
Available options:
TWO_STEP_ONBOARDING Example:
"TWO_STEP_ONBOARDING"
Workflow of the KYC process. HOSTED_BY_PROVIDER calls create KYC service and returns Yuno URL that redirects to provider. DIRECT calls create KYC service and processes KYC directly.
Available options:
HOSTED_BY_PROVIDER, DIRECT Example:
"HOSTED_BY_PROVIDER"
URL in case to redirect your customer after the onboarding process with the provider, if needed.
Example:
"https://www.google.com"
Show child attributes
Show child attributes
Specifies the documentation object.
Show child attributes
Show child attributes
Specifies the withdrawal methods object.
Show child attributes
Show child attributes
Object to indicate the owners of the organization. Adyen, Stripe and dlocal have fields related to that.
Show child attributes
Show child attributes
Object describing terms of service.
Show child attributes
Show child attributes
Response
Created
The unique identifier of the recipient.
Example:
"3aaa4d82-11e8-48ce-8ef5-04eee3a10802"
The account identifier associated with this recipient.
Example:
"fe14c7c6-c75e-43b7-bdbe-4c87ad52c482"
Unique identifier of the recipient defined by the merchant.
Example:
"MERCHANT_182acf1d-faeb-4ff0-94cd-7fab11b282f6"
Beneficiary's national entity type.
Example:
"INDIVIDUAL"
Beneficiary's type of organization.
Example:
"PRIVATE"
Beneficiary's name.
Example:
"Juan"
Beneficiary's last name.
Example:
"Perez"
Beneficiary's legal name.
Example:
null
The Beneficiary's email.
Example:
"juan.perez@example.com"
Beneficiary's date of birth.
Example:
"1990-01-15"
The Beneficiary's country.
Example:
"CO"
The seller's website URL.
Example:
"https://juanperez.com"
The seller's industry.
Example:
"Technology"
The merchant category code (MCC) (MAX 235; MIN 1).
Example:
"5734"
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Rules for automatic split calculation at the recipient level.
Show child attributes
Show child attributes
Recipient creation date (ISO 8601 MAX 27; MIN 27).
Example:
"2025-08-27T15:41:19.497413Z"
Last Recipient updated date (ISO 8601 MAX 27; MIN 27).
Example:
"2025-08-27T15:41:19.497425Z"
Was this page helpful?
Previous
Block OnboardingBlock a recipient's onboarding to temporarily prevent payouts for compliance or risk review
Next
⌘I
Continue Onboarding
curl --request POST \
--url https://api-sandbox.y.uno/v1/recipients/{recipient_id}/onboardings/{onboarding_id}/continue \
--header 'Content-Type: application/json' \
--header 'private-secret-key: <api-key>' \
--header 'public-api-key: <api-key>' \
--data '
{
"account_id": "9104911d-5df9-429e-8488-ad41abea1a4b",
"type": "TWO_STEP_ONBOARDING",
"workflow": "HOSTED_BY_PROVIDER",
"callback_url": "https://www.google.com",
"provider": {
"id": "PAGARME",
"connection_id": "104911d-5df9-429e-8488-ad41abea1a4b",
"recipient_id": "AAAAA01"
},
"documentation": [
{
"file_name": "PDF",
"content_type": "application/pdf",
"content": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCg=="
}
],
"withdrawal_methods": {
"bank": {
"code": "246",
"branch": "XXXX",
"branch_digit": "<string>",
"account": "1093333333",
"account_digit": "<string>",
"account_type": "SAVINGS",
"routing": "XXXXYYYYC",
"country": "CO",
"currency": "COP"
}
},
"legal_representatives": [
{
"merchant_reference": "<string>",
"first_name": "John",
"last_name": "Doe",
"email": "john.doe@email.com",
"date_of_birth": "1990-02-28",
"country": "CO",
"nationality": "CO",
"title": "CTO",
"publicly_exposed_person": false,
"ultimate_beneficial_owner": false
}
]
}
'import requests
url = "https://api-sandbox.y.uno/v1/recipients/{recipient_id}/onboardings/{onboarding_id}/continue"
payload = {
"account_id": "9104911d-5df9-429e-8488-ad41abea1a4b",
"type": "TWO_STEP_ONBOARDING",
"workflow": "HOSTED_BY_PROVIDER",
"callback_url": "https://www.google.com",
"provider": {
"id": "PAGARME",
"connection_id": "104911d-5df9-429e-8488-ad41abea1a4b",
"recipient_id": "AAAAA01"
},
"documentation": [
{
"file_name": "PDF",
"content_type": "application/pdf",
"content": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCg=="
}
],
"withdrawal_methods": { "bank": {
"code": "246",
"branch": "XXXX",
"branch_digit": "<string>",
"account": "1093333333",
"account_digit": "<string>",
"account_type": "SAVINGS",
"routing": "XXXXYYYYC",
"country": "CO",
"currency": "COP"
} },
"legal_representatives": [
{
"merchant_reference": "<string>",
"first_name": "John",
"last_name": "Doe",
"email": "john.doe@email.com",
"date_of_birth": "1990-02-28",
"country": "CO",
"nationality": "CO",
"title": "CTO",
"publicly_exposed_person": False,
"ultimate_beneficial_owner": False
}
]
}
headers = {
"public-api-key": "<api-key>",
"private-secret-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'public-api-key': '<api-key>',
'private-secret-key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
account_id: '9104911d-5df9-429e-8488-ad41abea1a4b',
type: 'TWO_STEP_ONBOARDING',
workflow: 'HOSTED_BY_PROVIDER',
callback_url: 'https://www.google.com',
provider: {
id: 'PAGARME',
connection_id: '104911d-5df9-429e-8488-ad41abea1a4b',
recipient_id: 'AAAAA01'
},
documentation: [
{
file_name: 'PDF',
content_type: 'application/pdf',
content: 'JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCg=='
}
],
withdrawal_methods: {
bank: {
code: '246',
branch: 'XXXX',
branch_digit: '<string>',
account: '1093333333',
account_digit: '<string>',
account_type: 'SAVINGS',
routing: 'XXXXYYYYC',
country: 'CO',
currency: 'COP'
}
},
legal_representatives: [
{
merchant_reference: '<string>',
first_name: 'John',
last_name: 'Doe',
email: 'john.doe@email.com',
date_of_birth: '1990-02-28',
country: 'CO',
nationality: 'CO',
title: 'CTO',
publicly_exposed_person: false,
ultimate_beneficial_owner: false
}
]
})
};
fetch('https://api-sandbox.y.uno/v1/recipients/{recipient_id}/onboardings/{onboarding_id}/continue', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api-sandbox.y.uno/v1/recipients/{recipient_id}/onboardings/{onboarding_id}/continue",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'account_id' => '9104911d-5df9-429e-8488-ad41abea1a4b',
'type' => 'TWO_STEP_ONBOARDING',
'workflow' => 'HOSTED_BY_PROVIDER',
'callback_url' => 'https://www.google.com',
'provider' => [
'id' => 'PAGARME',
'connection_id' => '104911d-5df9-429e-8488-ad41abea1a4b',
'recipient_id' => 'AAAAA01'
],
'documentation' => [
[
'file_name' => 'PDF',
'content_type' => 'application/pdf',
'content' => 'JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCg=='
]
],
'withdrawal_methods' => [
'bank' => [
'code' => '246',
'branch' => 'XXXX',
'branch_digit' => '<string>',
'account' => '1093333333',
'account_digit' => '<string>',
'account_type' => 'SAVINGS',
'routing' => 'XXXXYYYYC',
'country' => 'CO',
'currency' => 'COP'
]
],
'legal_representatives' => [
[
'merchant_reference' => '<string>',
'first_name' => 'John',
'last_name' => 'Doe',
'email' => 'john.doe@email.com',
'date_of_birth' => '1990-02-28',
'country' => 'CO',
'nationality' => 'CO',
'title' => 'CTO',
'publicly_exposed_person' => false,
'ultimate_beneficial_owner' => false
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"private-secret-key: <api-key>",
"public-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api-sandbox.y.uno/v1/recipients/{recipient_id}/onboardings/{onboarding_id}/continue"
payload := strings.NewReader("{\n \"account_id\": \"9104911d-5df9-429e-8488-ad41abea1a4b\",\n \"type\": \"TWO_STEP_ONBOARDING\",\n \"workflow\": \"HOSTED_BY_PROVIDER\",\n \"callback_url\": \"https://www.google.com\",\n \"provider\": {\n \"id\": \"PAGARME\",\n \"connection_id\": \"104911d-5df9-429e-8488-ad41abea1a4b\",\n \"recipient_id\": \"AAAAA01\"\n },\n \"documentation\": [\n {\n \"file_name\": \"PDF\",\n \"content_type\": \"application/pdf\",\n \"content\": \"JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCg==\"\n }\n ],\n \"withdrawal_methods\": {\n \"bank\": {\n \"code\": \"246\",\n \"branch\": \"XXXX\",\n \"branch_digit\": \"<string>\",\n \"account\": \"1093333333\",\n \"account_digit\": \"<string>\",\n \"account_type\": \"SAVINGS\",\n \"routing\": \"XXXXYYYYC\",\n \"country\": \"CO\",\n \"currency\": \"COP\"\n }\n },\n \"legal_representatives\": [\n {\n \"merchant_reference\": \"<string>\",\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"email\": \"john.doe@email.com\",\n \"date_of_birth\": \"1990-02-28\",\n \"country\": \"CO\",\n \"nationality\": \"CO\",\n \"title\": \"CTO\",\n \"publicly_exposed_person\": false,\n \"ultimate_beneficial_owner\": false\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("public-api-key", "<api-key>")
req.Header.Add("private-secret-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api-sandbox.y.uno/v1/recipients/{recipient_id}/onboardings/{onboarding_id}/continue")
.header("public-api-key", "<api-key>")
.header("private-secret-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"account_id\": \"9104911d-5df9-429e-8488-ad41abea1a4b\",\n \"type\": \"TWO_STEP_ONBOARDING\",\n \"workflow\": \"HOSTED_BY_PROVIDER\",\n \"callback_url\": \"https://www.google.com\",\n \"provider\": {\n \"id\": \"PAGARME\",\n \"connection_id\": \"104911d-5df9-429e-8488-ad41abea1a4b\",\n \"recipient_id\": \"AAAAA01\"\n },\n \"documentation\": [\n {\n \"file_name\": \"PDF\",\n \"content_type\": \"application/pdf\",\n \"content\": \"JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCg==\"\n }\n ],\n \"withdrawal_methods\": {\n \"bank\": {\n \"code\": \"246\",\n \"branch\": \"XXXX\",\n \"branch_digit\": \"<string>\",\n \"account\": \"1093333333\",\n \"account_digit\": \"<string>\",\n \"account_type\": \"SAVINGS\",\n \"routing\": \"XXXXYYYYC\",\n \"country\": \"CO\",\n \"currency\": \"COP\"\n }\n },\n \"legal_representatives\": [\n {\n \"merchant_reference\": \"<string>\",\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"email\": \"john.doe@email.com\",\n \"date_of_birth\": \"1990-02-28\",\n \"country\": \"CO\",\n \"nationality\": \"CO\",\n \"title\": \"CTO\",\n \"publicly_exposed_person\": false,\n \"ultimate_beneficial_owner\": false\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-sandbox.y.uno/v1/recipients/{recipient_id}/onboardings/{onboarding_id}/continue")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["public-api-key"] = '<api-key>'
request["private-secret-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"account_id\": \"9104911d-5df9-429e-8488-ad41abea1a4b\",\n \"type\": \"TWO_STEP_ONBOARDING\",\n \"workflow\": \"HOSTED_BY_PROVIDER\",\n \"callback_url\": \"https://www.google.com\",\n \"provider\": {\n \"id\": \"PAGARME\",\n \"connection_id\": \"104911d-5df9-429e-8488-ad41abea1a4b\",\n \"recipient_id\": \"AAAAA01\"\n },\n \"documentation\": [\n {\n \"file_name\": \"PDF\",\n \"content_type\": \"application/pdf\",\n \"content\": \"JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCg==\"\n }\n ],\n \"withdrawal_methods\": {\n \"bank\": {\n \"code\": \"246\",\n \"branch\": \"XXXX\",\n \"branch_digit\": \"<string>\",\n \"account\": \"1093333333\",\n \"account_digit\": \"<string>\",\n \"account_type\": \"SAVINGS\",\n \"routing\": \"XXXXYYYYC\",\n \"country\": \"CO\",\n \"currency\": \"COP\"\n }\n },\n \"legal_representatives\": [\n {\n \"merchant_reference\": \"<string>\",\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"email\": \"john.doe@email.com\",\n \"date_of_birth\": \"1990-02-28\",\n \"country\": \"CO\",\n \"nationality\": \"CO\",\n \"title\": \"CTO\",\n \"publicly_exposed_person\": false,\n \"ultimate_beneficial_owner\": false\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"id": "61df26d9-3750-4206-baab-f2e20683f35b",
"type": "TWO_STEP_ONBOARDING",
"workflow": "HOSTED_BY_PROVIDER",
"status": "PENDING",
"provider": {
"id": "STRIPE",
"connection_id": "8fee3cc6-f3cb-455d-b139-973866111a03",
"recipient_id": "acct_1RvpogA4Jk50vKRE",
"redirect_url": "https://api.y.uno/redirect/kyc/stripe/session_12345"
},
"created_at": "2025-08-22T17:57:58.460711Z",
"updated_at": "2025-08-22T18:15:22.123456Z"
}{
"code": "INVALID_REQUEST",
"messages": [
"Invalid request format"
]
}{
"code": "INVALID_CREDENTIALS",
"messages": [
"Invalid credentials"
]
}{
"code": "AUTHORIZATION_REQUIRED",
"messages": [
"The merchant has no authorization to use this API."
]
}