Submit Account Verification

Prev Next
This content is currently unavailable in Indonesian. You are viewing the default (English) version.

First, you will need to identify the entity type of your merchants. The required parameters are available below for each country and entity type (e.g. Philippines Corporation).

You may also need to get a your merchants to sign a Service Agreement with Xendit. Please consult your account manager and we will provide this template as necessary.

Upload KYC Files

Next, you will also need to use the Upload File API in order to upload the documents you collected from your merchants to Xendit, and save the IDs to include during the Account Verification submission.

POST https://api.xendit.co/files
{
  "purpose": "KYC_DOCUMENT",
  "file": "@/Users/MyName/Documents/identity-card.pdf"
}

Submit Account Verification

This POST API can be used to submit verification (KYC) information for your sub-account, and to resubmit information when requested. The required parameters are detailed below, but you can also view this page to see the required documents per country.

Ensure that your Platform account’s API key is granted the permissions below:

  • xenPlatform Accounts write

You will need to fill in the required parameters according to your sub-account’s country of incorporation and entity type. Refer to the list of requirements below to build your request body structure.

POST https://api.xendit.co/account_verification

Required Parameters

Headers

Field Name

Data Type

Description

for-user-id

string (optional)

The business ID of the sub-account

Body

Field Name

Data Type

Description

country_of_incorporation

string (required)

Country of incorporation in ISO format (e.g. SG, HK, CN, ID, etc.)

business_entity_type

string

(required)

The entity type. Must be one of: CORPORATION, PARTNERSHIP, SOLE_PROPRIETORSHIP

business_industry_code

string

(required)

The industry the business operates under. Must be one of the accepted Industry Codes below.

kyc_details

object (required)

The KYC Details object containing the KYC information of the sub-merchant. See the table below to view all the parameters.

third_party_verifications

array (optional)

An array of Third-party Verification objects, if necessary.

This is where we would require information from Jumio, Sanction Screening, Zhongshu Data, etc.

KYC Details

Field Name

Data Type

Description

business_legal_name

string (required)

The legal name registered for the business

business_description

string (required)

Description of your business

business_registration_number

string (required)

The legal business registration number

business_establishment_date

string (required)

The date of establishment of the business in YYYY-MM-DD format.

business_tax_number

string (optional)

The country-issued Tax ID number from the country of incorporation. Required for the following country_of_incorporation : ID, MY

business_address

object (required)

An Address Object for the address of the business.

legal_entity_address

object (required)

An Address Object for the address of the legal entity. May be the same as the business_address

office_store_address_proof_document

object (optional)

A File Object required if the legal address is not the same as the office/store address

proof_of_business_websites

object (optional)

A Proof of Business Websites object.

(At least 1 proof_of_business_websites or proof_of_business_documents is required)

proof_of_business_documents

array (optional)

An array of Proof of Business Document objects.

(At least 1 proof_of_business_websites or proof_of_business_documents is required)

business_registration_documents

array (required)

An array of Business Registration objects. Refer to the types below to see the required documents for each country.

business_license_documents

array (optional)

An array of File objects representing country and industry-specific business licenses, if applicable (e.g. Alcohol license, Cryptocurrency exchange license, etc.)

business_bank_account_document

object (optional)

A File object containing proof of the bank account ownership (bank book or statement).

business_bank_channel_code

string (optional)

Bank account number associated with the business for withdrawal. Required for the following country_of_incorporation : ID

business_bank_account_number

string (optional)

Bank code for the account number above such as BCA, BRI (retrieve bank codes using this API). Required for the following country_of_incorporation : ID

business_bank_name

string (optional)

Bank account holder name that must match the Business’ Legal Name. Required for the following country_of_incorporation : ID

business_intents

array (required)

An array containing the Xendit use cases for this merchant. Supported values: PAYMENTS, PAYOUT, GLOBAL_PAYOUT, BUSINESS_EXPENSES

business_average_monthly_basket_size

string (required)

The business’s estimated monthly transaction amount or gross sales. Please use one of the accepted string values below:

  • “lt $5K”

  • “$5K - 25K”

  • “$25K - $50K”

  • “$50K - $300K”

  • “$300K - $750K”

  • “gt $750K”

business_source_of_funds

array (optional)

An array listing the source of funds for the business. Supported values: REVENUE, INVESTOR_SHAREHOLDER_FUNDING, INVESTMENT_INCOME, BUSINESS_LOAN, PERSONAL_FUNDING, DONATIONS, GRANTS, OTHER

Authorized Person

authorized_person_first_name

string (required)

First name of the Authorized Person

authorized_person_last_name

string (required)

Last name or Surname of the Authorized Person

authorized_person_gender

string (required)

Supported values: M or F

authorized_person_nationality

string (required)

The authorized person’s nationality in ISO format

authorized_person_date_of_birth

string (required)

The authorized person’s date of birth in YYYY-MM-DD format

authorized_person_role

string (required)

Supported values: CEO, CTO, COO, CFO, FOUNDER, OWNER, DIRECTOR, MANAGING_DIRECTOR, GENERAL_PARTNER, PARTNER, TRUSTEE, OTHER

authorized_person_email_address

string (required)

Email address of the Contact Person

authorized_person_mobile_country_code

string (required)

Country code of the mobile number of the Authorized Person (E.g. +65)

authorized_person_mobile_number_only

string (required)

Mobile number of the Contact Person excluding the country code

authorized_person_address

object (required)

An Address Object for the address of the authorized person.

authorized_person_selfie_document

object (optional)

A File object for the selfie photo of the authorized representative

authorized_person_identification

array (required)

An array of Identification objects

authorized_person_proof_of_residency_document

object (optional)

A File object for the authorised person’s proof of address.

This is required if authorized_person_identification ID does not have an address indicated. (e.g. HK_NATIONAL_ID, PASSPORT)

authorized_person_board_resolution_document

object (optional)

A File object. Required for Corporations if the authorized representative is NOT listed as a Board Director

authorized_person_letter_of_authorization_document

object (optional)

A File object. This is required for:

  • Sole Proprietorship: if the authorized representative is NOT the business owner

  • Partnership: if the authorized representative is NOT a partner in the company

Contact Person (Can be the same as the Authorized Representative)

contact_person_first_name

string (required)

First name of the Contact Person

contact_person_last_name

string (required)

Last name or Surname of the Contact Person

contact_person_email_address

string (required)

Email address of the Contact Person

contact_person_mobile_country_code

string (required)

Country code of the mobile number of the Contact Person (E.g. +65)

contact_person_mobile_number_only

string (required)

Mobile number of the Contact Person excluding the country code

Shareholder Information

shareholders_include_corporate_entity

bool (required)

Specify true if at least one of the shareholders is a corporate entity. This will require a business_shareholding_chart_document to be uploaded.

business_shareholding_chart_document

object (optional)

A File object. Required if shareholders_include_corporate_entity is true

stakeholders

array (required)

An array of Stakeholder objects. There are different requirements depending on the entity type:

  • Corporations: At least 1 Board Director and 1 Business Owner

  • Partnership: At least 1 Partner and 1 Business Owner

  • Sole Proprietorship: At least 1 Business Owner

service_agreement_document

object (required)

A File object representing the service agreement signed by sub-merchants

Object References

Field Name

Data Type

Description

file_name

string (required)

The name or label for the file

file_id

string (required)

The file ID generated from the Upload API response

Field Name

Data Type

Description

street_line_1

string (required)

Required for all countries

street_line_2

string (optional)

Optional

city

string (required)

Required for all countries

district

string (optional)

Required for: ID, TH, VN

sub_district

string (optional)

Required for: ID, TH

province

string (optional)

Required for: ID, TH, VN

state

string (optional)

Required for: PH, MY

ward

string (optional)

Required for: VN

postal_code

string (required)

Required for all countries

country_code

string (required)

Country code in ISO format (SG, US, ID, etc.)

Proof of Business - Websites

Provide an object containing at least one of the following website URLs required.

Field Name

Data Type

Description

website

string (optional)

Website URL of the business

website_staging_url

string (optional)

A staging website URL of the business

website_staging_username

string (optional)

A username that can be used to log into the staging website

website_staging_password

string (optional)

The password that can be used to log into the staging website

social_instagram_url

string (optional)

Instagram profile URL

social_facebook_url

string (optional)

Facebook profile URL

social_others_url

string (optional)

Other social media profile URL

marketplace_url

string (optional)

A store URL under a marketplace website or application

Proof of Business - Documents

Provide an array of objects with these parameters. One or more documents can be submitted.

Field Name

Data Type

Description

type

string (required)

The type for the proof of business. Supported values: POSTER_BROCHURE_PAMPHLET_DOCUMENT, INVOICE_PURCHASE_ORDER_DOCUMENT, OFFLINE_STORE_PHOTO_DOCUMENT, OTHER_DOCUMENT

file_name

string (required)

The name or label for the file

file_id

string (required)

The file ID generated from the Upload API response

Field Name

Data Type

Description

type

string (required)

Required values based on the country_of_incorporation

Refer to the enumeration values below.

file_name

string (required)

The name or label for the file

file_id

string (required)

The file ID generated from the Upload API response

Field Name

Data Type

Description

roles

array (required)

An array containing these supported values: BOARD_DIRECTOR, BUSINESS_OWNER, LEGAL_PARTNER, AUTHORIZED_SIGNATORY

first_name

string (required)

First name of the stakeholder

last_name

string (required)

Last name or Surname of the stakeholder

nationality

string (required)

Nationality of the stakeholder (ISO format)

date_of_birth

string (required)

Date of birth of the stakeholder (YYYY-MM-DD format)

address

object (required)

An Address Object for the stakeholder

identification

array (required)

An array containing Identification objects

proof_of_residency_document

object (optional)

A File object for the authorised person’s proof of address.

This is required if identification submitted does not have an address indicated. (e.g. HK_NATIONAL_ID, PASSPORT)

Field Name

Data Type

Description

type

string (required)

The identification document or card type.

Refer to the enumeration values below.

number

string (required)

The identification document number

document_front

object (required)

A File object for the front of the ID document

document_back

object (required)

A File object for the back of the ID document

Field Name

Data Type

Description

type

string (required)

The type of verification completed for the sub-merchant. Supported values: SANCTION_SCREENING, GOVT_DATABASE, LIVENESS_VERIFICATION

date

string (required)

The date the verification was completed or extracted in YYYY-MM-DD format.

result

object (required)

A JSON object containing the verification results. This can be in any structure. It is advised to include the entity and individual names in the results.

Request Samples

Below are sample request payloads for different countries and types of entities.

{
   "country_of_incorporation": "HK",
   "business_entity_type": "CORPORATION",
   "business_industry_code": "ACCOUNTING_AUDITING_AND_BOOKKEEPING_SERVICES",
   "kyc_details": {
        "business_legal_name": "Sub Legal Name",
        "business_description": "Generic store",
        "business_registration_number": "XX12345678",
        "business_establishment_date": "2025-03-14",
        "business_segment": "SME",
        "business_address": {
            "street_line_1": "Prosperous Coml Bldg Causeway Bay",
            "sub_district": "Wan Chai District",
            "city": "Hong Kong",
            "state": "NA",
            "province": "NA",
            "postal_code": "999077",
            "country_code": "HK"
        },
        "legal_entity_address": {
            "street_line_1": "Prosperous Coml Bldg Causeway Bay",
            "sub_district": "Wan Chai District",
            "city": "Hong Kong",
            "state": "NA",
            "province": "NA",
            "postal_code": "999077",
            "country_code": "HK"
        },
        "office_store_address_proof_document": {
            "file_name": "Photo of offline business.jpg",
            "file_id": "file-5fbfd3e3-6d6d-493d-bef2-765462117527"
        },
        "proof_of_business_websites": {
          "website": "https://example.com"
        },
        "proof_of_business_documents": [
            {
                "type": "INVOICE_PURCHASE_ORDER_DOCUMENT",
                "file_name": "sample-invoice.pdf",
                "file_id": "file-c7bdf24b-738d-4c47-a919-55479daf7603"
            }
        ],
        "business_registration_documents": [
            {
                "type": "HK_CI",
                "file_name": "Certificate of Incorporation.pdf",
                "file_id": "file-c7bdf24b-738d-4c47-a919-55479daf7603"
            },
            {
                "type": "HK_NAR1",
                "file_name": "NAR1.pdf",
                "file_id": "file-c7bdf24b-738d-4c47-a919-55479daf7603"
            }
        ],
        "business_license_documents": [
          {
            "file_name": "bus-license.pdf",
            "file_id": "file-c7bdf24b-738d-4c47-a919-55479daf7603"
          }
        ],
        "business_bank_account_document": {
            "file_name": "bank-account.pdf",
            "file_id": "file-c7bdf24b-738d-4c47-a919-55479daf7603"
        },
        "business_average_monthly_basket_size": "$50K - $300K",
        "business_source_of_funds": [
            "REVENUE"
        ],
        "business_shareholding_chart_document": {
            "file_name": "NAR1 - Annual Report.pdf",
            "file_id": "file-c7bdf24b-738d-4c47-a919-55479daf7603"
        },
        "business_intents": [
            "PAYMENTS"
        ],
        "authorized_person_first_name": "Jackie",
        "authorized_person_last_name": "Chung",
        "authorized_person_gender": "M",
        "authorized_person_nationality": "HK",
        "authorized_person_date_of_birth": "1960-01-30",
        "authorized_person_role": "FOUNDER",
        "authorized_person_mobile_country_code": "+852",
        "authorized_person_mobile_number_only": "28405817",
        "authorized_person_email_address": "johndoe@test.com",
        "authorized_person_address": {
            "street_line_1": "Two Pacific Place",
            "sub_district": "Queensway",
            "city": "Hong Kong",
            "state": "NA",
            "province": "NA",
            "postal_code": "999077",
            "country_code": "HK"
        },
        "authorized_person_selfie_document": {
            "file_name": "jackie-chung-selfie.jpg",
            "file_id": "file-5a552596-d507-45a7-9dcf-51b214da1cec"
        },
        "authorized_person_identification": [
            {
                "type": "PASSPORT",
                "number": "X123456AA",
                "document_front": {
                    "file_name": "passport-front.jpg",
                    "file_id": "file-5fbfd3e3-6d6d-493d-bef2-765462117527"
                },
                "document_back": {
                    "file_name": "passport-back.jpg",
                    "file_id": "file-5fbfd3e3-6d6d-493d-bef2-765462117527"
                }
            }
        ],
        "authorized_person_proof_of_residency_document": {
            "file_name": "proof-of-residency.pdf",
            "file_id": "file-c7bdf24b-738d-4c47-a919-55479daf7603"
        },
        "authorized_person_board_resolution_document": {
            "file_name": "sample-file.pdf",
            "file_id": "file-c7bdf24b-738d-4c47-a919-55479daf7603"
        },
        "contact_person_first_name": "Jennie",
        "contact_person_last_name": "Chiu",
        "contact_person_mobile_country_code": "+852",
        "contact_person_mobile_number_only": "25701174",
        "contact_person_email_address": "jennie@test.com",
        "stakeholders": [
            {
                "roles": ["BUSINESS_OWNER", "BOARD_DIRECTOR"],
                "first_name": "Jackie",
                "last_name": "Chung",
                "nationality": "HK",
                "date_of_birth": "1960-01-30",
                "address": {
                    "street_line_1": "Two Pacific Place",
                    "sub_district": "Queensway",
                    "city": "Hong Kong",
                    "state": "NA",
                    "province": "NA",
                    "postal_code": "999077",
                    "country_code": "HK"
                },
                "identification": [
                    {
                        "type": "PASSPORT",
                        "number": "X123456AA",
                        "document_front": {
                            "file_name": "passport-front.jpg",
                            "file_id": "file-5fbfd3e3-6d6d-493d-bef2-765462117527"
                        },
                        "document_back": {
                            "file_name": "passport-back.jpg",
                            "file_id": "file-5fbfd3e3-6d6d-493d-bef2-765462117527"
                        }
                    }
                ],
                "proof_of_residency_document": {
                    "file_name": "proof-of-residency.pdf",
                    "file_id": "file-c7bdf24b-738d-4c47-a919-55479daf7603"
                }
            },
            {
                "roles": ["BOARD_DIRECTOR"],
                "first_name": "Jenny",
                "last_name": "Chiu",
                "nationality": "HK",
                "date_of_birth": "1975-02-25",
                "address": {
                    "street_line_1": "Three Pacific Place",
                    "city": "Queensway",
                    "state": "Hong Kong",
                    "postal_code": "999077",
                    "country_code": "HK"
                },
                "identification": [
                    {
                        "type": "HK_NATIONAL_ID",
                        "number": "ABCD12345",
                        "document_front": {
                            "file_name": "passport-front.jpg",
                            "file_id": "file-5fbfd3e3-6d6d-493d-bef2-765462117527"
                        },
                        "document_back": {
                            "file_name": "passport-back.jpg",
                            "file_id": "file-5fbfd3e3-6d6d-493d-bef2-765462117527"
                        }
                    }
                ]
            }
        ],
        "shareholders_include_corporate_entity": false,
        "service_agreement_document": {
            "file_name": "agreement.pdf",
            "file_id": "file-c7bdf24b-738d-4c47-a919-55479daf7603"
        }
   },
   "third_party_verifications": [
       {
           "type": "GOVT_DATABASE",
           "date": "2025-02-01",
           "result": {
                "name": "Jackie Chung",
                "source": "HK_GOVT",
                "verified": true
           }
       },
       {
           "type": "SANCTION_SCREENING",
           "date": "2025-02-01",
           "result": {
                "name": "Jackie Chung",
                "is_sanctioned_entity": false
           }
       }
   ]
}
{
   "country_of_incorporation": "ID",
   "business_entity_type": "CORPORATION",
   "business_industry_code": "ACCOUNTING_AUDITING_AND_BOOKKEEPING_SERVICES",
   "kyc_details": {
        "business_legal_name": "Sub Legal Name",
        "business_description": "Generic store",
        "business_registration_number": "XX12345678",
        "business_tax_number": "12345678901234",
        "business_establishment_date": "2025-03-14",
        "business_segment": "SME",
        "business_address": {
            "street_line_1": "Jalan Merdeka 1234",
            "district": "Kebayoran Baru",
            "sub_district": "Melawai",
            "city": "Jakarta Selatan",
            "state": "DKI Jakarta",
            "province": "DKI Jakarta",
            "postal_code": "12345",
            "country_code": "ID"
        },
        "legal_entity_address": {
            "street_line_1": "Jalan Merdeka 1234",
            "district": "Kebayoran Baru",
            "sub_district": "Melawai",
            "city": "Jakarta Selatan",
            "state": "DKI Jakarta",
            "province": "DKI Jakarta",
            "postal_code": "12345",
            "country_code": "ID"
        },
        "office_store_address_proof_document": {
            "file_name": "Photo of offline business.jpg",
            "file_id": "file-7871a410-2ea4-4518-bd0d-9dabdb506179"
        },
        "proof_of_business_websites": {
          "website": "https://example.com"
        },
        "proof_of_business_documents": [
            {
                "type": "INVOICE_PURCHASE_ORDER_DOCUMENT",
                "file_name": "sample-invoice.pdf",
                "file_id": "file-6f4fb582-5306-469a-b234-9e67f64fa2aa"
            }
        ],
        "business_registration_documents": [
            {
                "type": "ID_NIB",
                "file_name": "reg-doc.pdf",
                "file_id": "file-6f4fb582-5306-469a-b234-9e67f64fa2aa"
            },
            {
                "type": "ID_COMPANY_NPWP",
                "file_name": "reg-doc.pdf",
                "file_id": "file-6f4fb582-5306-469a-b234-9e67f64fa2aa"
            },
            {
                "type": "ID_AKTA",
                "file_name": "reg-doc.pdf",
                "file_id": "file-6f4fb582-5306-469a-b234-9e67f64fa2aa"
            },
            {
                "type": "ID_SKMENKEH",
                "file_name": "reg-doc.pdf",
                "file_id": "file-6f4fb582-5306-469a-b234-9e67f64fa2aa"
            }
        ],
        "business_license_documents": [
          {
            "file_name": "bus-license.pdf",
            "file_id": "file-6f4fb582-5306-469a-b234-9e67f64fa2aa"
          }
        ],
        "business_bank_account_document": {
            "file_name": "bank-account.pdf",
            "file_id": "file-6f4fb582-5306-469a-b234-9e67f64fa2aa"
        },
        "business_average_monthly_basket_size": "$50K - $300K",
        "business_source_of_funds": [
            "REVENUE"
        ],
        "business_shareholding_chart_document": {
            "file_name": "NAR1 - Annual Report.pdf",
            "file_id": "file-6f4fb582-5306-469a-b234-9e67f64fa2aa"
        },
        "business_intents": [
            "PAYMENTS"
        ],
        "business_bank_account_number": "12345678",
        "business_bank_channel_code": "ID_BCA",
        "business_bank_name": "Teguh Perkasa",
        "business_registration_documents_amended": false,
        "authorized_person_first_name": "Puput",
        "authorized_person_last_name": "Widodo",
        "authorized_person_gender": "F",
        "authorized_person_nationality": "HK",
        "authorized_person_date_of_birth": "1980-01-30",
        "authorized_person_role": "FOUNDER",
        "authorized_person_mobile_country_code": "+62",
        "authorized_person_mobile_number_only": "28405817",
        "authorized_person_email_address": "johndoe@test.com",
        "authorized_person_address": {
            "street_line_1": "Jalan Merdeka 1234",
            "district": "Kebayoran Baru",
            "sub_district": "Melawai",
            "city": "Jakarta Selatan",
            "state": "DKI Jakarta",
            "province": "DKI Jakarta",
            "postal_code": "12345",
            "country_code": "ID"
        },
        "authorized_person_selfie_document": {
            "file_name": "auth-person-selfie.jpg",
            "file_id": "file-5a552596-d507-45a7-9dcf-51b214da1cec"
        },
        "authorized_person_identification": [
            {
                "type": "PASSPORT",
                "number": "X123456AA",
                "document_front": {
                    "file_name": "passport-front.jpg",
                    "file_id": "file-7871a410-2ea4-4518-bd0d-9dabdb506179"
                },
                "document_back": {
                    "file_name": "passport-back.jpg",
                    "file_id": "file-7871a410-2ea4-4518-bd0d-9dabdb506179"
                }
            }
        ],
        "authorized_person_proof_of_residency_document": {
            "file_name": "proof-of-residency.pdf",
            "file_id": "file-6f4fb582-5306-469a-b234-9e67f64fa2aa"
        },
        "authorized_person_board_resolution_document": {
            "file_name": "sample-file.pdf",
            "file_id": "file-6f4fb582-5306-469a-b234-9e67f64fa2aa"
        },
        "contact_person_first_name": "Teguh",
        "contact_person_last_name": "Perkasa",
        "contact_person_mobile_country_code": "+62",
        "contact_person_mobile_number_only": "25701174",
        "contact_person_email_address": "example@test.com",
        "stakeholders": [
            {
                "roles": ["BUSINESS_OWNER", "BOARD_DIRECTOR"],
                "first_name": "Puput",
                "last_name": "Widodo",
                "nationality": "ID",
                "date_of_birth": "1980-01-30",
                "address": {
                    "street_line_1": "Jalan Merdeka 1234",
                    "district": "Kebayoran Baru",
                    "sub_district": "Melawai",
                    "city": "Jakarta Selatan",
                    "state": "DKI Jakarta",
                    "province": "DKI Jakarta",
                    "postal_code": "12345",
                    "country_code": "ID"
                },
                "identification": [
                    {
                        "type": "PASSPORT",
                        "number": "X123456AA",
                        "document_front": {
                            "file_name": "passport-front.jpg",
                            "file_id": "file-7871a410-2ea4-4518-bd0d-9dabdb506179"
                        },
                        "document_back": {
                            "file_name": "passport-back.jpg",
                            "file_id": "file-7871a410-2ea4-4518-bd0d-9dabdb506179"
                        }
                    }
                ],
                "proof_of_residency_document": {
                    "file_name": "proof-of-residency.pdf",
                    "file_id": "file-6f4fb582-5306-469a-b234-9e67f64fa2aa"
                }
            },
            {
                "roles": ["BOARD_DIRECTOR"],
                "first_name": "Teguh",
                "last_name": "Perkasa",
                "nationality": "ID",
                "date_of_birth": "1975-02-25",
                "address": {
                    "street_line_1": "Jalan Merdeka 1234",
                    "district": "Kebayoran Baru",
                    "sub_district": "Melawai",
                    "city": "Jakarta Selatan",
                    "state": "DKI Jakarta",
                    "province": "DKI Jakarta",
                    "postal_code": "12345",
                    "country_code": "ID"
                },
                "identification": [
                    {
                        "type": "ID_NATIONAL_ID_KTP",
                        "number": "1234567890123456",
                        "document_front": {
                            "file_name": "ktp-front.jpg",
                            "file_id": "file-7871a410-2ea4-4518-bd0d-9dabdb506179"
                        },
                        "document_back": {
                            "file_name": "ktp-back.jpg",
                            "file_id": "file-7871a410-2ea4-4518-bd0d-9dabdb506179"
                        }
                    }
                ]
            }
        ],
        "shareholders_include_corporate_entity": false,
        "service_agreement_document": {
            "file_name": "agreement.pdf",
            "file_id": "file-6f4fb582-5306-469a-b234-9e67f64fa2aa"
        }
   }
}

Response

Field Name

Data Type

Description

id

string

The unique KYC request ID

status

string

Verification status. This should be VERIFICATION_IN_PROGRESS upon first submission.

business_id

string

The business ID of the sub-account linked to the verification request

country_of_incorporation

string

The entity’s country of incorporation in ISO format

business_entity_type

string

The entity type

kyc_details

object

The KYC Details object that was submitted

Errors

Error

Error Code

Description

INVALID_DATA_SUBMITTED

400

The field name provided in the payload is not supported and cannot be stored in our KYC data. Please follow the parameter list above.

The fields provided in the payload do not satisfy requirements. Please provide the required parameters above.

REQUEST_FORBIDDEN_ERROR

403

The API key is forbidden to perform this request. You need to use the Platform API key with Account Verification write access.

INVALID_API_KEY

401

The API key format is invalid

XEN_PLATFORM_SUB_ACCOUNT_NOT_LIVE

404

KYC API submission is only allowed for sub-accounts created in LIVE mode, the sub-accounts created in TEST mode cannot be used to submit KYC through the API

SERVER_ERROR

500

Something unexpected, our devs have been notified to troubleshoot the issue

Enumeration Value Reference

CORPORATION
PARTNERSHIP
SOLE_PROPRIETORSHIP
ACCOUNTING_AUDITING_AND_BOOKKEEPING_SERVICES
ADVERTISING_SERVICES
AGRICULTURAL_COOPERATIVES
ALCOHOLIC_BEVERAGE_WHOLESALERS
AMUSEMENT_PARKS_CIRCUSES_CARNIVALS_AND_FORTUNE_TELLERS
ANTIQUE_REPRODUCTION_SHOPS
ARCHITECTURAL_ENGINEERING_AND_SURVEYING_SERVICES
ART_AND_CRAFTS_NEW
ASSET_MANAGEMENT_COMPANY_NEW
AUCTION
AUTOMATED_FUEL_DISPENSERS
AUTOMOBILE_RENTALS
AUTOMOTIVE_BODY_REPAIR_SHOPS
AUTOMOTIVE_CAR_MOTORCYCLE_BOATS_AND_MISCELLANEOUS_AUTOMOTIVE_EQUIPMENT_DEALER
AUTOMOTIVE_PARTS_AND_ACCESSORIES_OUTLETS
AUTOMOTIVE_REPAIR_WASHES_AND_TOWING_SERVICE
BAKERIES
BANKS
BEAUTY_AND_BARBER_SHOPS
BILLIARD_AND_POOL_ESTABLISHMENTS
BOAT_RENTAL_MARINAS_AND_MARINE_SERVICE_INC_SUPPLIES
BOOKS_AND_STATIONARY
BUSINESS_AND_SECRETARIAL_SCHOOLS
BUYING_AND_SHOPPING_SERVICES_AND_CLUBS
CABLE_AND_OTHER_PAY_TELEVISION_SERVICES
CAMERA_AND_PHOTOGRAPHIC_SUPPLY_SHOPS
CAR_AND_TRUCK_DEALERS_SALES_SERVICES_REPAIRS_PARTS_AND_LEASING
CARPET_AND_UPHOLSTERY_CLEANING
CATERERS
CHARITABLE_AND_SOCIAL_SERVICE_ORGANIZATIONS
CHILD_CARE_SERVICES
CHIROPRACTORS
CIGAR_SHOPS_AND_STANDS
CIVIC_SOCIAL_AND_FRATERNAL_ASSOCIATIONS
CLEANING_MAINTENANCE_AND_JANITORIAL_SERVICES
CLOTHING_RENTALS_COSTUMES_UNIFORMS_AND_FORMAL_WEAR
CLOTHING_STORES
COMMERCIAL_PHOTOGRAPHY_ART_AND_GRAPHICS
COMPUTER_NETWORKINFORMATION_SERVICES
COMPUTER_SOFTWARE_OUTLETS
CONSUMER_CREDIT_REPORTING_AGENCIES
CONTRACTORS_STONEWORK_INSULATION_CAPENTRY_ROOFING_CONCRETE_OTHER
CORRESPONDENCE_SCHOOLS
COSMETIC_SHOPS_EXISTING_BRAND
COSMETIC_SHOPS_OWN_BRAND
COUNSELLING_SERVICES_DEBT_MARRIAGE_AND_PERSONAL
CRYPTOCURRENCY
DANCE_HALLS_STUDIOS_AND_SCHOOLS
DATING_AND_ESCORT_SERVICES
DEALSITES_NON_DIGITAL_VOUCHER
DEALSITES_SELLING_EVOUCHER
DENTAL_LABORATORY_MEDICAL_OPHTHALMIC_HOSPITAL_EQUIPMENT_AND_SUPPLIES
DENTISTS
DEPARTMENT_STORES
DETECTIVE_AGENCIES_PROTECTIVE_AGENCIES_AND_SECURITY_SERVICES_INCLUDING_ARMOURED_CARS_AND_GUARD_DOGS
DIGITAL_GOODS
DIRECT_MARKETING_CATALOGUE_MERCHANTS
DIRECT_MARKETING_COMBINATION_CATALOGUE_AND_RETAIL_MERCHANTS
DIRECT_MARKETING_CONTINUITYSUBSCRIPTION_MERCHANTS
DIRECT_MARKETING_INBOUND_TELEMARKETING_MERCHANTS
DIRECT_MARKETING_INSURANCE_SERVICES
DIRECT_MARKETING_OUTBOUND_TELEMARKETING_MERCHANTS
DISCOUNT_SHOPS
DOORTODOOR_SALES
DRAPERY_WINDOW_COVERING_UPHOLSTERY_FIREPLACES_FIREPLACE_SCREENS_AND_ACCESSORIES_SHOPS
DRINKING_PLACES_ALCOHOLIC_BEVERAGES_BARS_TAVERNS_NIGHTCLUBS_COCKTAIL_LOUNGES_AND_DISCOTHQUES
DRUG_STORES_AND_PHARMACIES
DRUGS_DRUG_PROPRIETORS
DUTYFREE_SHOPS
EATING_PLACES_AND_RESTAURANTS
ECOMMERCE
ELECTRIC_RAZOR_SHOPS_SALES_AND_SERVICE
ELECTRIC_VEHICLE_CHARGING
ELECTRONICS_AND_ACCESSORIES_NEW
ELECTRONICS_REPAIR_SHOPS
EMPLOYMENT_AGENCIES_AND_TEMPORARY_HELP_SERVICES
EQUIPMENT_TOOL_FURNITURE_AND_APPLIANCE_RENTALS_AND_LEASING
EWALLETS
EXTERMINATING_AND_DISINFECTING_SERVICES
FAST_FOOD_RESTAURANTS
FINANCIAL_INSTITUTIONS_AUTOMATED_CASH_DISBURSEMENTS
FINANCIAL_INSTITUTIONS_MANUAL_CASH_DISBURSEMENTS
FINANCIAL_INSTITUTIONS_MERCHANDISE_AND_SERVICES
FIREPLACES_FIREPLACE_SCREENS_AND_ACCESSORIES_SHOPS
FLOOR_COVERING_SERVICES
FLORISTS
FLORISTS_SUPPLIES_NURSERY_STOCK_AND_FLOWERS
FUEL_DEALERS_FUEL_OIL_WOOD_COAL_AND_LIQUEFIED_PETROLEUM
FUNERAL_SERVICES_AND_CREMATORIUMS
FURNITURE_HOME_FURNISHINGS_AND_EQUIPMENT_SHOPS_AND_MANUFACTURERS_EXCEPT_APPLIANCES
GENERAL_CONTRACTORS_RESIDENTIAL_AND_COMMERCIAL
GIFT_CARD_NOVELTY_AND_SOUVENIR_SHOPS
GLASSWARE_AND_CRYSTAL_SHOPS
HAJ_AND_UMRAH_PROVIDER_NEW
HEALTH_AND_BEAUTY_SPAS
HEALTH_SUPPLEMENT_SELLING_OWN_BRAND
HEARING_AIDS_ORTHOPAEDIC_GOODS_AND_PROSTHETIC_DEVICES_SALES_SERVICE_AND_SUPPLIES
HEATING_PLUMBING_AND_AIRCONDITIONING_CONTRACTORS
HOBBY_TOY_AND_GAME_SHOPS
HOME_SUPPLY_HARDWARE_AND_OTHER_BUILDING_MATERIALS
HOSPITALS
HOUSEHOLD_APPLICANCES_HOME_FURNISHING_AND_ELECTRONICS_SHOPS
INSURANCE_SALES_UNDERWRITING_AND_PREMIUMS
INSURTECH
INTERNET_SERVICE_PROVIDER_NEW
INVESTMENT_SERVICES_NEW
IT_SERVICES_NEW
JEWELLERY_WATCH_CLOCK_AND_SILVERWARE_SHOPS
LANDSCAPING_AND_HORTICULTURAL_SERVICES
LAUNDRY_CLEANING_AND_GARMENT_SERVICES
LAWN_AND_GARDEN_SUPPLIES_OUTLETS_INCLUDING_NURSERIES
LEGAL_SERVICES_AND_ATTORNEYS
LENDING
LOCAL_AND_SUBURBAN_COMMUTER_PASSENGER_TRANSPORTATION_INCLUDING_FERRIES
LODGING_HOTELS_MOTELS_AND_RESORTS
LUGGAGE_AND_LEATHER_GOODS_SHOPS
MANAGEMENT_CONSULTING_AND_PUBLIC_RELATIONS_SERVICES
MARKETPLACE_NEW
MASSAGE_PARLOURS
MEDICAL_AND_DENTAL_LABORATORIES
MEMBERSHIP_CLUBS_SPORTS_RECREATION_ATHLETIC_COUNTRY_CLUBS_AND_PRIVATE_GOLF_COURSES
METAL_SERVICE_CENTRES_AND_OFFICES
MISCELLANEOUS_AND_SPECIALITY_RETAIL_OUTLETS
MISCELLANEOUS_APPAREL_AND_ACCESSORY_SHOPS
MISCELLANEOUS_FOOD_SHOPS_CONVENIENCE_AND_SPECIALITY_RETAIL_OUTLETS
MISCELLANEOUS_GENERAL_MERCHANDISE
MISCELLANEOUS_REPAIR_SHOPS_AND_RELATED_SERVICES
MOBILE_HOME_DEALERS
MONTHLY_SUMMARY_TELEPHONE_CHARGES
MOTION_PICTURE_THEATRES
MOTOR_FREIGHT_CARRIERS_AND_TRUCKING_LOCAL_AND_LONG_DISTANCE_MOVING_AND_STORAGE_COMPANIES_AND_LOCAL_DELIVERY
MOTOR_VEHICLE_SUPPLIES_AND_NEW_PARTS
MULTI_FINANCE_COMPANY
MULTI_LEVEL_MARKETING_NEW
MUSIC_SHOPS_MUSICAL_INSTRUMENTS_PIANOS_AND_SHEET_MUSIC
NEWSAGENTS_AND_NEWSSTANDS
NON_FINANCIAL_INSTITUTIONS_FOREIGN_CURRENCY_MONEY_ORDERS_NOT_WIRE_TRANSFER_SCRIP_AND_TRAVELLERS_CHECKS
NURSING_AND_PERSONAL_CARE_FACILITIES
OFFICE_AND_COMMERCIAL_FURNITURE
OFFICE_PHOTOGRAPHIC_COMMERCIAL_EQUIPMENT_AND_OTHER_INDUSTRIAL_SUPPLIES
OPTICIANS_OPTICAL_GOODS_AND_EYEGLASSES
OPTOMETRISTS_AND_OPHTHALMOLOGISTS
OSTEOPATHS
OTHER_BUSINESS_SERVICES
OTHER_CHEMICALS_AND_ALLIED_PRODUCTS
OTHER_CONSTRUCTION_MATERIALS
OTHER_DIRECT_MARKETINGDIRECT_MARKETERS
OTHER_DOCTORS_AND_PHYSICIANS
OTHER_DURABLE_GOODS
OTHER_GOVERNMENT_SERVICES
OTHER_MEDICAL_SERVICES_AND_HEALTH_PRACTITIONERS
OTHER_MEMBERSHIP_ORGANIZATIONS
OTHER_MISCELLANEOUS_PERSONAL_SERVICES
OTHER_NONDURABLE_GOODS
OTHER_PROFESSIONAL_SERVICES
OTHER_RECREATION_SERVICES
OTHER_TRANSPORTATION_SERVICES
PACKAGE_SHOPS_BEER_WINE_AND_LIQUOR
PARKING_LOTS_AND_GARAGES
PAWN_SHOPS
PAYMENT_GATEWAY_NEW
PEERTOPEER_LENDING
PET_SHOPS_PET_FOOD_AND_SUPPLIES
PETROLEUM_AND_PETROLEUM_PRODUCTS
PHOTOFINISHING_LABORATORIES_AND_PHOTO_DEVELOPING
PHOTOGRAPHIC_STUDIOS
PIECE_GOODS_NOTIONS_AND_OTHER_DRY_GOODS
PLUMBING_AND_HEATING_EQUIPMENT_AND_SUPPLIES
PODIATRISTS_AND_CHIROPODISTS
POLITICAL_ORGANIZATIONS
PRECIOUS_STONES_AND_METALS_WATCHES_AND_JEWELLERY
PUBLIC_WAREHOUSING_AND_STORAGE_FARM_PRODUCTS_REFRIGERATED_GOODS_AND_HOUSEHOLD_GOODS
REAL_ESTATE_AGENTS_AND_MANAGERS
RECORD_SHOPS
RELIGIOUS_GOODS_AND_SHOPS
RELIGIOUS_ORGANIZATIONS
REMITTANCE_NEW
RIDE_SHARING_NEW
SCHOOLS_UNIVERSITY_AND_EDUCATIONAL_SERVICE_INC_TRADE_AND_VOCATIONAL_SCHOOL
SECURITIES_BROKERS_AND_DEALERS
SERVICE_STATIONS_WITH_OR_WITHOUT_ANCILLARY_SERVICES
SEWING_NEEDLEWORK_FABRIC_AND_PIECE_GOODS_SHOPS
SHOE_REPAIR_SHOPS_SHOE_SHINE_PARLOURS_AND_HAT_CLEANING_SHOPS
SHOE_SHOPS
SPECIALITY_CLEANING_POLISHING_AND_SANITATION_PREPARATIONS
SPORTING_AND_RECREATIONAL_CAMPS
SPORTING_GOODS_NEW
SPORTS_AND_RIDING_APPAREL_SHOPS
SUPERMARKET_CONVENIENCE_STORES_CONFECTIONERY_SHOPS_AND_BUTCHERY
SWIMMING_POOLS_SALES_SUPPLIES_AND_SERVICES
TAILORS_SEAMSTRESSES_MENDING_AND_ALTERATIONS
TAX_PAYMENTS
TAX_PREPARATION_SERVICES
TAXICABS_AND_LIMOUSINES
TELECOMMUNICATION_EQUIPMENT_AND_TELEPHONE_SALES
TELECOMMUNICATION_SERVICES_INCLUDING_LOCAL_AND_LONG_DISTANCE_CALLS_CREDIT_CARD_CALLS_CALLS_THROUGH_USE_OF_MAGNETIC_STRIPE_READING_TELEPHONES_AND_FAXES
TELEGRAPH_SERVICES
TELEMARKETING_TRAVEL_RELATED_ARRANGEMENT_SERVICES
TENT_AND_AWNING_SHOPS
TESTING_LABORATORIES_NONMEDICAL
THEATRICAL_PRODUCERS_EXCEPT_MOTION_PICTURES_AND_TICKET_AGENCIES
TIMESHARES
TOLLS_AND_BRIDGE_FEES
TOURIST_ATTRACTIONS_AND_EXHIBITS
TRAILER_PARKS_AND_CAMPSITES
TRAINING_ONLINE_INCLASS_SHORT_COURSES
TRAVEL_AGENCIES_AND_TOUR_OPERATORS
TRUCK_AND_UTILITY_TRAILER_RENTALS
TYPEWRITER_OUTLETS_SALES_SERVICE_AND_RENTALS
UNIFORM_AND_COMMERCIAL_CLOTHING
UTILITIES_ELECTRIC_GAS_WATER_AND_SANITARY
VETERINARY_SERVICES
VIDEO_AMUSEMENT_GAME_SUPPLIES
VIDEO_GAME_ARCADES_AND_ESTABLISHMENTS
VIDEO_TAPE_RENTALS
WELDING_SERVICES
WIRE_TRANSFERS_AND_MONEY_ORDERS
WRECKING_AND_SALVAGE_YARDS
ZAKAT_COLLECTION_NEW

Country

Document Codes

Singapore

SG_ACRA

Indonesia

ID_NIB, ID_COMPANY_NPWP, ID_AKTA, ID_SKMENKEH

Philippines

PH_ARTICLES_OF_INCORPORATION, PH_ARTICLES_OF_PARTNERSHIP, PH_DTI_REGISTRATION, PH_GIS, PH_NOTARIZED_PARTNER_CERTIFICATE, PH_NOTARIZED_SECRETARY_CERTIFICATE, PH_BIR_2303

Malaysia

MY_BUSINESS_REGISTRATION_CERT, MY_SEC_SEVENTEEN, MY_SSM_PROFILE, MY_SHAREHOLDERS, MY_ORGANIZATIONAL_CHART

Thailand

TH_COMPANY_CERT, TH_FOUNDATION_LICENSE, TH_BOJ_FIVE, TH_FOUNDATION_REGULATION, TH_FOUNDATION_REGISTRATION_CORRECTION, TH_ASSOCIATION_GAZETTE, TH_PARTNER_DEED

Vietnam

VN_ENTERPRISE_REGISTRATION_CERT

Others

HK_CERT_OF_INCORPORATION, HK_BRP, HK_NAR1, CN_BUSINESS_LICENSE

Country

Document Codes

International (Any)

PASSPORT

Singapore

SG_NATIONAL_ID_NRIC, SG_NATIONAL_ID_NRIC_DIGITAL

Indonesia

ID_NATIONAL_ID_KTP, ID_KITAS_KITAP

Philippines

PH_DRIVERS_LICENSE, PH_PHILSYS_PHYSICAL, PH_PHILSYS_DIGITAL, PH_UMID, PH_SSS_OR_GSIS, PH_PRC_LICENSE, PH_POSTAL_ID, PH_VOTER_ID, PH_ACR_OR_IMMIGRANT_COR

Malaysia

MY_NATIONAL_ID_MYKAD

Thailand

TH_NATIONAL_ID

Vietnam

VN_NATIONAL_ID

Others

HK_NATIONAL_ID, CN_NATIONAL_ID_RIC