Resubmit Sub-Merchant KYC
curl --request POST \
--url https://mapi.zbx.com/v1/partners/orgs/{orgId}/kyc/resubmit \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--header 'X-API-Nonce: <api-key>' \
--header 'X-API-Signature: <api-key>' \
--data '
{
"kyc_level": "CDD",
"kyc_questionnaire": {
"acting_capacity": "156",
"annual_income": "75",
"employment_jurisdiction": "MT",
"employment_type_or_status": "16",
"expected_deposit_one_year": "83",
"hnwi_str": "79",
"industry": "51",
"investment_citizenship": "82",
"sdd_country_select": "MT",
"source_of_funds": "66,70",
"source_of_funds_of_country": "MT,DE",
"source_of_wealth_of_country": "MT"
},
"share_token": "<string>"
}
'import requests
url = "https://mapi.zbx.com/v1/partners/orgs/{orgId}/kyc/resubmit"
payload = {
"kyc_level": "CDD",
"kyc_questionnaire": {
"acting_capacity": "156",
"annual_income": "75",
"employment_jurisdiction": "MT",
"employment_type_or_status": "16",
"expected_deposit_one_year": "83",
"hnwi_str": "79",
"industry": "51",
"investment_citizenship": "82",
"sdd_country_select": "MT",
"source_of_funds": "66,70",
"source_of_funds_of_country": "MT,DE",
"source_of_wealth_of_country": "MT"
},
"share_token": "<string>"
}
headers = {
"X-API-KEY": "<api-key>",
"X-API-Nonce": "<api-key>",
"X-API-Signature": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'X-API-KEY': '<api-key>',
'X-API-Nonce': '<api-key>',
'X-API-Signature': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
kyc_level: 'CDD',
kyc_questionnaire: {
acting_capacity: '156',
annual_income: '75',
employment_jurisdiction: 'MT',
employment_type_or_status: '16',
expected_deposit_one_year: '83',
hnwi_str: '79',
industry: '51',
investment_citizenship: '82',
sdd_country_select: 'MT',
source_of_funds: '66,70',
source_of_funds_of_country: 'MT,DE',
source_of_wealth_of_country: 'MT'
},
share_token: '<string>'
})
};
fetch('https://mapi.zbx.com/v1/partners/orgs/{orgId}/kyc/resubmit', 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://mapi.zbx.com/v1/partners/orgs/{orgId}/kyc/resubmit",
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([
'kyc_level' => 'CDD',
'kyc_questionnaire' => [
'acting_capacity' => '156',
'annual_income' => '75',
'employment_jurisdiction' => 'MT',
'employment_type_or_status' => '16',
'expected_deposit_one_year' => '83',
'hnwi_str' => '79',
'industry' => '51',
'investment_citizenship' => '82',
'sdd_country_select' => 'MT',
'source_of_funds' => '66,70',
'source_of_funds_of_country' => 'MT,DE',
'source_of_wealth_of_country' => 'MT'
],
'share_token' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-KEY: <api-key>",
"X-API-Nonce: <api-key>",
"X-API-Signature: <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://mapi.zbx.com/v1/partners/orgs/{orgId}/kyc/resubmit"
payload := strings.NewReader("{\n \"kyc_level\": \"CDD\",\n \"kyc_questionnaire\": {\n \"acting_capacity\": \"156\",\n \"annual_income\": \"75\",\n \"employment_jurisdiction\": \"MT\",\n \"employment_type_or_status\": \"16\",\n \"expected_deposit_one_year\": \"83\",\n \"hnwi_str\": \"79\",\n \"industry\": \"51\",\n \"investment_citizenship\": \"82\",\n \"sdd_country_select\": \"MT\",\n \"source_of_funds\": \"66,70\",\n \"source_of_funds_of_country\": \"MT,DE\",\n \"source_of_wealth_of_country\": \"MT\"\n },\n \"share_token\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-KEY", "<api-key>")
req.Header.Add("X-API-Nonce", "<api-key>")
req.Header.Add("X-API-Signature", "<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://mapi.zbx.com/v1/partners/orgs/{orgId}/kyc/resubmit")
.header("X-API-KEY", "<api-key>")
.header("X-API-Nonce", "<api-key>")
.header("X-API-Signature", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"kyc_level\": \"CDD\",\n \"kyc_questionnaire\": {\n \"acting_capacity\": \"156\",\n \"annual_income\": \"75\",\n \"employment_jurisdiction\": \"MT\",\n \"employment_type_or_status\": \"16\",\n \"expected_deposit_one_year\": \"83\",\n \"hnwi_str\": \"79\",\n \"industry\": \"51\",\n \"investment_citizenship\": \"82\",\n \"sdd_country_select\": \"MT\",\n \"source_of_funds\": \"66,70\",\n \"source_of_funds_of_country\": \"MT,DE\",\n \"source_of_wealth_of_country\": \"MT\"\n },\n \"share_token\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://mapi.zbx.com/v1/partners/orgs/{orgId}/kyc/resubmit")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["X-API-Nonce"] = '<api-key>'
request["X-API-Signature"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"kyc_level\": \"CDD\",\n \"kyc_questionnaire\": {\n \"acting_capacity\": \"156\",\n \"annual_income\": \"75\",\n \"employment_jurisdiction\": \"MT\",\n \"employment_type_or_status\": \"16\",\n \"expected_deposit_one_year\": \"83\",\n \"hnwi_str\": \"79\",\n \"industry\": \"51\",\n \"investment_citizenship\": \"82\",\n \"sdd_country_select\": \"MT\",\n \"source_of_funds\": \"66,70\",\n \"source_of_funds_of_country\": \"MT,DE\",\n \"source_of_wealth_of_country\": \"MT\"\n },\n \"share_token\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"kyc_next_action": "<string>",
"kyc_status": "pending",
"org_id": "<string>"
},
"error": true,
"message": "<string>"
}{
"error": {
"code": 400,
"errors": [
{
"domain": "orders",
"reason": "InsufficientQuantity"
}
],
"message": "Insufficient quantity"
}
}{
"error": {
"code": 400,
"errors": [
{
"domain": "orders",
"reason": "InsufficientQuantity"
}
],
"message": "Insufficient quantity"
}
}{
"error": {
"code": 400,
"errors": [
{
"domain": "orders",
"reason": "InsufficientQuantity"
}
],
"message": "Insufficient quantity"
}
}{
"error": {
"code": 400,
"errors": [
{
"domain": "orders",
"reason": "InsufficientQuantity"
}
],
"message": "Insufficient quantity"
}
}{
"error": {
"code": 400,
"errors": [
{
"domain": "orders",
"reason": "InsufficientQuantity"
}
],
"message": "Insufficient quantity"
}
}{
"error": {
"code": 400,
"errors": [
{
"domain": "orders",
"reason": "InsufficientQuantity"
}
],
"message": "Insufficient quantity"
}
}Partners
Resubmit Sub-Merchant KYC
Import a KYC you hold in Sumsub again: share_token with kyc_questionnaire, same rules as create. kyc_level CDD (default) is accepted for a merchant with no KYC yet, at SDD level, or with kyc_next_action cdd_required; SDD only for a merchant with no KYC yet. Answers 202 with kyc_status pending (accepted for an SDD merchant, who keeps trading); the result arrives as an Org.Updated webhook. Errors: 409 not_required or not_eligible, 424 share_token_rejected or kyc_questionnaire_rejected.
POST
/
partners
/
orgs
/
{orgId}
/
kyc
/
resubmit
Resubmit Sub-Merchant KYC
curl --request POST \
--url https://mapi.zbx.com/v1/partners/orgs/{orgId}/kyc/resubmit \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--header 'X-API-Nonce: <api-key>' \
--header 'X-API-Signature: <api-key>' \
--data '
{
"kyc_level": "CDD",
"kyc_questionnaire": {
"acting_capacity": "156",
"annual_income": "75",
"employment_jurisdiction": "MT",
"employment_type_or_status": "16",
"expected_deposit_one_year": "83",
"hnwi_str": "79",
"industry": "51",
"investment_citizenship": "82",
"sdd_country_select": "MT",
"source_of_funds": "66,70",
"source_of_funds_of_country": "MT,DE",
"source_of_wealth_of_country": "MT"
},
"share_token": "<string>"
}
'import requests
url = "https://mapi.zbx.com/v1/partners/orgs/{orgId}/kyc/resubmit"
payload = {
"kyc_level": "CDD",
"kyc_questionnaire": {
"acting_capacity": "156",
"annual_income": "75",
"employment_jurisdiction": "MT",
"employment_type_or_status": "16",
"expected_deposit_one_year": "83",
"hnwi_str": "79",
"industry": "51",
"investment_citizenship": "82",
"sdd_country_select": "MT",
"source_of_funds": "66,70",
"source_of_funds_of_country": "MT,DE",
"source_of_wealth_of_country": "MT"
},
"share_token": "<string>"
}
headers = {
"X-API-KEY": "<api-key>",
"X-API-Nonce": "<api-key>",
"X-API-Signature": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'X-API-KEY': '<api-key>',
'X-API-Nonce': '<api-key>',
'X-API-Signature': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
kyc_level: 'CDD',
kyc_questionnaire: {
acting_capacity: '156',
annual_income: '75',
employment_jurisdiction: 'MT',
employment_type_or_status: '16',
expected_deposit_one_year: '83',
hnwi_str: '79',
industry: '51',
investment_citizenship: '82',
sdd_country_select: 'MT',
source_of_funds: '66,70',
source_of_funds_of_country: 'MT,DE',
source_of_wealth_of_country: 'MT'
},
share_token: '<string>'
})
};
fetch('https://mapi.zbx.com/v1/partners/orgs/{orgId}/kyc/resubmit', 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://mapi.zbx.com/v1/partners/orgs/{orgId}/kyc/resubmit",
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([
'kyc_level' => 'CDD',
'kyc_questionnaire' => [
'acting_capacity' => '156',
'annual_income' => '75',
'employment_jurisdiction' => 'MT',
'employment_type_or_status' => '16',
'expected_deposit_one_year' => '83',
'hnwi_str' => '79',
'industry' => '51',
'investment_citizenship' => '82',
'sdd_country_select' => 'MT',
'source_of_funds' => '66,70',
'source_of_funds_of_country' => 'MT,DE',
'source_of_wealth_of_country' => 'MT'
],
'share_token' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-KEY: <api-key>",
"X-API-Nonce: <api-key>",
"X-API-Signature: <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://mapi.zbx.com/v1/partners/orgs/{orgId}/kyc/resubmit"
payload := strings.NewReader("{\n \"kyc_level\": \"CDD\",\n \"kyc_questionnaire\": {\n \"acting_capacity\": \"156\",\n \"annual_income\": \"75\",\n \"employment_jurisdiction\": \"MT\",\n \"employment_type_or_status\": \"16\",\n \"expected_deposit_one_year\": \"83\",\n \"hnwi_str\": \"79\",\n \"industry\": \"51\",\n \"investment_citizenship\": \"82\",\n \"sdd_country_select\": \"MT\",\n \"source_of_funds\": \"66,70\",\n \"source_of_funds_of_country\": \"MT,DE\",\n \"source_of_wealth_of_country\": \"MT\"\n },\n \"share_token\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-KEY", "<api-key>")
req.Header.Add("X-API-Nonce", "<api-key>")
req.Header.Add("X-API-Signature", "<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://mapi.zbx.com/v1/partners/orgs/{orgId}/kyc/resubmit")
.header("X-API-KEY", "<api-key>")
.header("X-API-Nonce", "<api-key>")
.header("X-API-Signature", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"kyc_level\": \"CDD\",\n \"kyc_questionnaire\": {\n \"acting_capacity\": \"156\",\n \"annual_income\": \"75\",\n \"employment_jurisdiction\": \"MT\",\n \"employment_type_or_status\": \"16\",\n \"expected_deposit_one_year\": \"83\",\n \"hnwi_str\": \"79\",\n \"industry\": \"51\",\n \"investment_citizenship\": \"82\",\n \"sdd_country_select\": \"MT\",\n \"source_of_funds\": \"66,70\",\n \"source_of_funds_of_country\": \"MT,DE\",\n \"source_of_wealth_of_country\": \"MT\"\n },\n \"share_token\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://mapi.zbx.com/v1/partners/orgs/{orgId}/kyc/resubmit")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["X-API-Nonce"] = '<api-key>'
request["X-API-Signature"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"kyc_level\": \"CDD\",\n \"kyc_questionnaire\": {\n \"acting_capacity\": \"156\",\n \"annual_income\": \"75\",\n \"employment_jurisdiction\": \"MT\",\n \"employment_type_or_status\": \"16\",\n \"expected_deposit_one_year\": \"83\",\n \"hnwi_str\": \"79\",\n \"industry\": \"51\",\n \"investment_citizenship\": \"82\",\n \"sdd_country_select\": \"MT\",\n \"source_of_funds\": \"66,70\",\n \"source_of_funds_of_country\": \"MT,DE\",\n \"source_of_wealth_of_country\": \"MT\"\n },\n \"share_token\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"kyc_next_action": "<string>",
"kyc_status": "pending",
"org_id": "<string>"
},
"error": true,
"message": "<string>"
}{
"error": {
"code": 400,
"errors": [
{
"domain": "orders",
"reason": "InsufficientQuantity"
}
],
"message": "Insufficient quantity"
}
}{
"error": {
"code": 400,
"errors": [
{
"domain": "orders",
"reason": "InsufficientQuantity"
}
],
"message": "Insufficient quantity"
}
}{
"error": {
"code": 400,
"errors": [
{
"domain": "orders",
"reason": "InsufficientQuantity"
}
],
"message": "Insufficient quantity"
}
}{
"error": {
"code": 400,
"errors": [
{
"domain": "orders",
"reason": "InsufficientQuantity"
}
],
"message": "Insufficient quantity"
}
}{
"error": {
"code": 400,
"errors": [
{
"domain": "orders",
"reason": "InsufficientQuantity"
}
],
"message": "Insufficient quantity"
}
}{
"error": {
"code": 400,
"errors": [
{
"domain": "orders",
"reason": "InsufficientQuantity"
}
],
"message": "Insufficient quantity"
}
}Authorizations
Path Parameters
Organisation ID returned by create
Body
application/json
Share token, level and answers to import
KYC level to import share_token at: CDD (the default) when the Sumsub applicant holds an identity document, liveness and a proof of address issued in the last 3 months; SDD when it holds only the identity document. SDD is accepted only before the merchant is verified. Only accepted with share_token.
Available options:
SDD, CDD Example:
"CDD"
Answers to ZBX's KYC questionnaire. Required with share_token, and only accepted with it. With kyc_level SDD only the six answers from sdd_country_select to acting_capacity are used; the rest are ignored.
Show child attributes
Show child attributes
Sumsub share token from your own Sumsub account, generated for ZBX's Sumsub client id. Required, with kyc_questionnaire.