Submit KYC

Submit KYC

curl --request POST \
  --url https://api.cadanapay.com/v1/users/{userId}/kyc \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "firstName": "John",
  "lastName": "Doe",
  "dob": "1990-01-15",
  "nationality": "US",
  "address": {
    "line1": "123 Main Street",
    "line2": "Apt 101",
    "city": "Anytown",
    "postalCode": "12345",
    "state": "NY",
    "countryCode": "US"
  },
  "idDetails": {
    "type": "passport",
    "number": "123456789",
    "issuedCountryCode": "US",
    "issuedBy": "Department of State",
    "issuedDate": "2020-01-15",
    "expirationDate": "2030-01-15",
    "frontFileId": "1d3f870c-bc91-4636-a0d4-8e54bccf7d64",
    "backFileId": "2e4a981d-cd02-4747-b29d-3f65dd8e7d75",
    "selfieFileId": "3f5b092e-de13-4858-a40e-4c76ee9f8e86"
  },
  "addressProofFileId": "4a6b103f-ef24-4969-b51f-5d87ff0a9f97"
}
'

import requests

url = "https://api.cadanapay.com/v1/users/{userId}/kyc"

payload = {
    "firstName": "John",
    "lastName": "Doe",
    "dob": "1990-01-15",
    "nationality": "US",
    "address": {
        "line1": "123 Main Street",
        "line2": "Apt 101",
        "city": "Anytown",
        "postalCode": "12345",
        "state": "NY",
        "countryCode": "US"
    },
    "idDetails": {
        "type": "passport",
        "number": "123456789",
        "issuedCountryCode": "US",
        "issuedBy": "Department of State",
        "issuedDate": "2020-01-15",
        "expirationDate": "2030-01-15",
        "frontFileId": "1d3f870c-bc91-4636-a0d4-8e54bccf7d64",
        "backFileId": "2e4a981d-cd02-4747-b29d-3f65dd8e7d75",
        "selfieFileId": "3f5b092e-de13-4858-a40e-4c76ee9f8e86"
    },
    "addressProofFileId": "4a6b103f-ef24-4969-b51f-5d87ff0a9f97"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    firstName: 'John',
    lastName: 'Doe',
    dob: '1990-01-15',
    nationality: 'US',
    address: {
      line1: '123 Main Street',
      line2: 'Apt 101',
      city: 'Anytown',
      postalCode: '12345',
      state: 'NY',
      countryCode: 'US'
    },
    idDetails: {
      type: 'passport',
      number: '123456789',
      issuedCountryCode: 'US',
      issuedBy: 'Department of State',
      issuedDate: '2020-01-15',
      expirationDate: '2030-01-15',
      frontFileId: '1d3f870c-bc91-4636-a0d4-8e54bccf7d64',
      backFileId: '2e4a981d-cd02-4747-b29d-3f65dd8e7d75',
      selfieFileId: '3f5b092e-de13-4858-a40e-4c76ee9f8e86'
    },
    addressProofFileId: '4a6b103f-ef24-4969-b51f-5d87ff0a9f97'
  })
};

fetch('https://api.cadanapay.com/v1/users/{userId}/kyc', 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.cadanapay.com/v1/users/{userId}/kyc",
  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([
    'firstName' => 'John',
    'lastName' => 'Doe',
    'dob' => '1990-01-15',
    'nationality' => 'US',
    'address' => [
        'line1' => '123 Main Street',
        'line2' => 'Apt 101',
        'city' => 'Anytown',
        'postalCode' => '12345',
        'state' => 'NY',
        'countryCode' => 'US'
    ],
    'idDetails' => [
        'type' => 'passport',
        'number' => '123456789',
        'issuedCountryCode' => 'US',
        'issuedBy' => 'Department of State',
        'issuedDate' => '2020-01-15',
        'expirationDate' => '2030-01-15',
        'frontFileId' => '1d3f870c-bc91-4636-a0d4-8e54bccf7d64',
        'backFileId' => '2e4a981d-cd02-4747-b29d-3f65dd8e7d75',
        'selfieFileId' => '3f5b092e-de13-4858-a40e-4c76ee9f8e86'
    ],
    'addressProofFileId' => '4a6b103f-ef24-4969-b51f-5d87ff0a9f97'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$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.cadanapay.com/v1/users/{userId}/kyc"

	payload := strings.NewReader("{\n  \"firstName\": \"John\",\n  \"lastName\": \"Doe\",\n  \"dob\": \"1990-01-15\",\n  \"nationality\": \"US\",\n  \"address\": {\n    \"line1\": \"123 Main Street\",\n    \"line2\": \"Apt 101\",\n    \"city\": \"Anytown\",\n    \"postalCode\": \"12345\",\n    \"state\": \"NY\",\n    \"countryCode\": \"US\"\n  },\n  \"idDetails\": {\n    \"type\": \"passport\",\n    \"number\": \"123456789\",\n    \"issuedCountryCode\": \"US\",\n    \"issuedBy\": \"Department of State\",\n    \"issuedDate\": \"2020-01-15\",\n    \"expirationDate\": \"2030-01-15\",\n    \"frontFileId\": \"1d3f870c-bc91-4636-a0d4-8e54bccf7d64\",\n    \"backFileId\": \"2e4a981d-cd02-4747-b29d-3f65dd8e7d75\",\n    \"selfieFileId\": \"3f5b092e-de13-4858-a40e-4c76ee9f8e86\"\n  },\n  \"addressProofFileId\": \"4a6b103f-ef24-4969-b51f-5d87ff0a9f97\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	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.cadanapay.com/v1/users/{userId}/kyc")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"firstName\": \"John\",\n  \"lastName\": \"Doe\",\n  \"dob\": \"1990-01-15\",\n  \"nationality\": \"US\",\n  \"address\": {\n    \"line1\": \"123 Main Street\",\n    \"line2\": \"Apt 101\",\n    \"city\": \"Anytown\",\n    \"postalCode\": \"12345\",\n    \"state\": \"NY\",\n    \"countryCode\": \"US\"\n  },\n  \"idDetails\": {\n    \"type\": \"passport\",\n    \"number\": \"123456789\",\n    \"issuedCountryCode\": \"US\",\n    \"issuedBy\": \"Department of State\",\n    \"issuedDate\": \"2020-01-15\",\n    \"expirationDate\": \"2030-01-15\",\n    \"frontFileId\": \"1d3f870c-bc91-4636-a0d4-8e54bccf7d64\",\n    \"backFileId\": \"2e4a981d-cd02-4747-b29d-3f65dd8e7d75\",\n    \"selfieFileId\": \"3f5b092e-de13-4858-a40e-4c76ee9f8e86\"\n  },\n  \"addressProofFileId\": \"4a6b103f-ef24-4969-b51f-5d87ff0a9f97\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.cadanapay.com/v1/users/{userId}/kyc")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"firstName\": \"John\",\n  \"lastName\": \"Doe\",\n  \"dob\": \"1990-01-15\",\n  \"nationality\": \"US\",\n  \"address\": {\n    \"line1\": \"123 Main Street\",\n    \"line2\": \"Apt 101\",\n    \"city\": \"Anytown\",\n    \"postalCode\": \"12345\",\n    \"state\": \"NY\",\n    \"countryCode\": \"US\"\n  },\n  \"idDetails\": {\n    \"type\": \"passport\",\n    \"number\": \"123456789\",\n    \"issuedCountryCode\": \"US\",\n    \"issuedBy\": \"Department of State\",\n    \"issuedDate\": \"2020-01-15\",\n    \"expirationDate\": \"2030-01-15\",\n    \"frontFileId\": \"1d3f870c-bc91-4636-a0d4-8e54bccf7d64\",\n    \"backFileId\": \"2e4a981d-cd02-4747-b29d-3f65dd8e7d75\",\n    \"selfieFileId\": \"3f5b092e-de13-4858-a40e-4c76ee9f8e86\"\n  },\n  \"addressProofFileId\": \"4a6b103f-ef24-4969-b51f-5d87ff0a9f97\"\n}"

response = http.request(request)
puts response.read_body

{
  "code": "invalid_request_body",
  "message": "The request body provided is not valid",
  "params": {
    "field": "Value is invalid."
  }
}

{
  "code": "resource_not_found",
  "message": "Requested resource could not be found."
}

{
  "code": "internal_error",
  "message": "An unexpected error occurred. Please try again later."
}

POST

users

{userId}

kyc

Submit KYC

curl --request POST \
  --url https://api.cadanapay.com/v1/users/{userId}/kyc \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "firstName": "John",
  "lastName": "Doe",
  "dob": "1990-01-15",
  "nationality": "US",
  "address": {
    "line1": "123 Main Street",
    "line2": "Apt 101",
    "city": "Anytown",
    "postalCode": "12345",
    "state": "NY",
    "countryCode": "US"
  },
  "idDetails": {
    "type": "passport",
    "number": "123456789",
    "issuedCountryCode": "US",
    "issuedBy": "Department of State",
    "issuedDate": "2020-01-15",
    "expirationDate": "2030-01-15",
    "frontFileId": "1d3f870c-bc91-4636-a0d4-8e54bccf7d64",
    "backFileId": "2e4a981d-cd02-4747-b29d-3f65dd8e7d75",
    "selfieFileId": "3f5b092e-de13-4858-a40e-4c76ee9f8e86"
  },
  "addressProofFileId": "4a6b103f-ef24-4969-b51f-5d87ff0a9f97"
}
'

import requests

url = "https://api.cadanapay.com/v1/users/{userId}/kyc"

payload = {
    "firstName": "John",
    "lastName": "Doe",
    "dob": "1990-01-15",
    "nationality": "US",
    "address": {
        "line1": "123 Main Street",
        "line2": "Apt 101",
        "city": "Anytown",
        "postalCode": "12345",
        "state": "NY",
        "countryCode": "US"
    },
    "idDetails": {
        "type": "passport",
        "number": "123456789",
        "issuedCountryCode": "US",
        "issuedBy": "Department of State",
        "issuedDate": "2020-01-15",
        "expirationDate": "2030-01-15",
        "frontFileId": "1d3f870c-bc91-4636-a0d4-8e54bccf7d64",
        "backFileId": "2e4a981d-cd02-4747-b29d-3f65dd8e7d75",
        "selfieFileId": "3f5b092e-de13-4858-a40e-4c76ee9f8e86"
    },
    "addressProofFileId": "4a6b103f-ef24-4969-b51f-5d87ff0a9f97"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    firstName: 'John',
    lastName: 'Doe',
    dob: '1990-01-15',
    nationality: 'US',
    address: {
      line1: '123 Main Street',
      line2: 'Apt 101',
      city: 'Anytown',
      postalCode: '12345',
      state: 'NY',
      countryCode: 'US'
    },
    idDetails: {
      type: 'passport',
      number: '123456789',
      issuedCountryCode: 'US',
      issuedBy: 'Department of State',
      issuedDate: '2020-01-15',
      expirationDate: '2030-01-15',
      frontFileId: '1d3f870c-bc91-4636-a0d4-8e54bccf7d64',
      backFileId: '2e4a981d-cd02-4747-b29d-3f65dd8e7d75',
      selfieFileId: '3f5b092e-de13-4858-a40e-4c76ee9f8e86'
    },
    addressProofFileId: '4a6b103f-ef24-4969-b51f-5d87ff0a9f97'
  })
};

fetch('https://api.cadanapay.com/v1/users/{userId}/kyc', 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.cadanapay.com/v1/users/{userId}/kyc",
  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([
    'firstName' => 'John',
    'lastName' => 'Doe',
    'dob' => '1990-01-15',
    'nationality' => 'US',
    'address' => [
        'line1' => '123 Main Street',
        'line2' => 'Apt 101',
        'city' => 'Anytown',
        'postalCode' => '12345',
        'state' => 'NY',
        'countryCode' => 'US'
    ],
    'idDetails' => [
        'type' => 'passport',
        'number' => '123456789',
        'issuedCountryCode' => 'US',
        'issuedBy' => 'Department of State',
        'issuedDate' => '2020-01-15',
        'expirationDate' => '2030-01-15',
        'frontFileId' => '1d3f870c-bc91-4636-a0d4-8e54bccf7d64',
        'backFileId' => '2e4a981d-cd02-4747-b29d-3f65dd8e7d75',
        'selfieFileId' => '3f5b092e-de13-4858-a40e-4c76ee9f8e86'
    ],
    'addressProofFileId' => '4a6b103f-ef24-4969-b51f-5d87ff0a9f97'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$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.cadanapay.com/v1/users/{userId}/kyc"

	payload := strings.NewReader("{\n  \"firstName\": \"John\",\n  \"lastName\": \"Doe\",\n  \"dob\": \"1990-01-15\",\n  \"nationality\": \"US\",\n  \"address\": {\n    \"line1\": \"123 Main Street\",\n    \"line2\": \"Apt 101\",\n    \"city\": \"Anytown\",\n    \"postalCode\": \"12345\",\n    \"state\": \"NY\",\n    \"countryCode\": \"US\"\n  },\n  \"idDetails\": {\n    \"type\": \"passport\",\n    \"number\": \"123456789\",\n    \"issuedCountryCode\": \"US\",\n    \"issuedBy\": \"Department of State\",\n    \"issuedDate\": \"2020-01-15\",\n    \"expirationDate\": \"2030-01-15\",\n    \"frontFileId\": \"1d3f870c-bc91-4636-a0d4-8e54bccf7d64\",\n    \"backFileId\": \"2e4a981d-cd02-4747-b29d-3f65dd8e7d75\",\n    \"selfieFileId\": \"3f5b092e-de13-4858-a40e-4c76ee9f8e86\"\n  },\n  \"addressProofFileId\": \"4a6b103f-ef24-4969-b51f-5d87ff0a9f97\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	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.cadanapay.com/v1/users/{userId}/kyc")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"firstName\": \"John\",\n  \"lastName\": \"Doe\",\n  \"dob\": \"1990-01-15\",\n  \"nationality\": \"US\",\n  \"address\": {\n    \"line1\": \"123 Main Street\",\n    \"line2\": \"Apt 101\",\n    \"city\": \"Anytown\",\n    \"postalCode\": \"12345\",\n    \"state\": \"NY\",\n    \"countryCode\": \"US\"\n  },\n  \"idDetails\": {\n    \"type\": \"passport\",\n    \"number\": \"123456789\",\n    \"issuedCountryCode\": \"US\",\n    \"issuedBy\": \"Department of State\",\n    \"issuedDate\": \"2020-01-15\",\n    \"expirationDate\": \"2030-01-15\",\n    \"frontFileId\": \"1d3f870c-bc91-4636-a0d4-8e54bccf7d64\",\n    \"backFileId\": \"2e4a981d-cd02-4747-b29d-3f65dd8e7d75\",\n    \"selfieFileId\": \"3f5b092e-de13-4858-a40e-4c76ee9f8e86\"\n  },\n  \"addressProofFileId\": \"4a6b103f-ef24-4969-b51f-5d87ff0a9f97\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.cadanapay.com/v1/users/{userId}/kyc")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"firstName\": \"John\",\n  \"lastName\": \"Doe\",\n  \"dob\": \"1990-01-15\",\n  \"nationality\": \"US\",\n  \"address\": {\n    \"line1\": \"123 Main Street\",\n    \"line2\": \"Apt 101\",\n    \"city\": \"Anytown\",\n    \"postalCode\": \"12345\",\n    \"state\": \"NY\",\n    \"countryCode\": \"US\"\n  },\n  \"idDetails\": {\n    \"type\": \"passport\",\n    \"number\": \"123456789\",\n    \"issuedCountryCode\": \"US\",\n    \"issuedBy\": \"Department of State\",\n    \"issuedDate\": \"2020-01-15\",\n    \"expirationDate\": \"2030-01-15\",\n    \"frontFileId\": \"1d3f870c-bc91-4636-a0d4-8e54bccf7d64\",\n    \"backFileId\": \"2e4a981d-cd02-4747-b29d-3f65dd8e7d75\",\n    \"selfieFileId\": \"3f5b092e-de13-4858-a40e-4c76ee9f8e86\"\n  },\n  \"addressProofFileId\": \"4a6b103f-ef24-4969-b51f-5d87ff0a9f97\"\n}"

response = http.request(request)
puts response.read_body

{
  "code": "invalid_request_body",
  "message": "The request body provided is not valid",
  "params": {
    "field": "Value is invalid."
  }
}

{
  "code": "resource_not_found",
  "message": "Requested resource could not be found."
}

{
  "code": "internal_error",
  "message": "An unexpected error occurred. Please try again later."
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

X-MultiTenantKey

string

Required when using a Platform API token. The tenant key identifying which business to operate on.

Path Parameters

userId

string<uuid>

required

The unique identifier for the user

Body

application/json

firstName

string

required

User's first name

Example:

"John"

lastName

string

required

User's last name

Example:

"Doe"

dob

string<date>

required

Date of birth in YYYY-MM-DD format

Example:

"1990-01-15"

nationality

string

required

User's nationality (2-letter country code)

Example:

"US"

idDetails

object

required

Show child attributes

address

object

Address

Show child attributes

addressProofFileId

string<uuid>

File ID for address proof document

Example:

"4a6b103f-ef24-4969-b51f-5d87ff0a9f97"

Response

KYC information submitted successfully

Get KYC

Resubmit KYC

⌘I

Overview

Payments API

Wallets API

Workforce API

Tax API

Statutory Compliance API

Authorizations

Headers

Path Parameters

Body

Response