Submit Client KYC

About 297 wordsLess than 1 minute

POST /public/v1/users/{user_id}/profile/submit

Path Variables

Name	Type	Required	Rule	Description
`custom_fields`	`fields`	Optional		additional fields configured in kyc form
form_id	`string`	Mandatory	length `8`	the id of kyc form
phone	`object`	Optional		the phone of user
phone.country_code	`string`	Optional		user's phone country code
phone.number	`string`	Optional		user's phone number

Expected HTTP status code

200

Response

Name	Type	Description
id	`string`

Error

Code	Type	Description
`400`	`account_not_found`	Cannot find user from user_id
`400`	`invalid_request`	Cannot find processing profile request
`400`	`kyc_duplicate_error`	Kyc Info duplicate

Custom Field

Custom fields are JSON root fields. The field key is a random key obtained from the form, and the value follows the example format below.

Type	Input Format	Example
`text` / `textarea` / `description`	String	`"Hello World"`
`number`	Number	`123.45`
`number_string`	Numeric String	`"123456789"`
`boolean`	Boolean	`true` or `false`
`radio` / `select`	String	`"option1"`
`dynamicSelect`	Any	`"any_value"`
`multiselect` / `checkbox`	Array	`["value1", "value2"]`
`date`	String (YYYY-MM-DD)	`"2024-06-15"`
`document`	Array of Objects	`[{"id": "doc123", "name": "file.pdf", "doc": "base64"}]`
`phone`	Object	`{"country_code": "86", "number": "13800138000"}`
`email`	String	`"[email protected]"`
`country` / `nation`	String	`"CN"`
`location`	Object	`{"country": "CN", "state": "GD", "city": "SZ"}`
`participants` / `leads`	Array	`[{...}, {...}]`

Complete JSON Example

{
  "custom_key_text": "Hello World",
  "custom_key_textarea": "This is a long text content for textarea field",
  "custom_key_description": "This is a description field content",
  "custom_key_number": 123.45,
  "custom_key_number_string": "123456789",
  "custom_key_boolean": true,
  "custom_key_radio": "option1",
  "custom_key_select": "option2",
  "custom_key_dynamicSelect": "dynamic_value",
  "custom_key_multiselect": ["value1", "value2", "value3"],
  "custom_key_checkbox": ["option1", "option2"],
  "custom_key_date": "2024-06-15",
  "custom_key_document": [
    {
      "id": "doc001",
      "name": "ID_Card.pdf",
      "doc": "base64_encoded_string"
    }
  ],
  "custom_key_phone": {
    "country_code": "86",
    "number": "13800138000"
  },
  "custom_key_email": "[email protected]",
  "custom_key_country": "CN",
  "custom_key_nation": "CN",
  "custom_key_location": {
    "country": "CN",
    "state": "Guangdong",
    "city": "Shenzhen"
  },
  "custom_key_participants": [
    { "id": "p001", "name": "Participant 1" }
  ],
  "custom_key_leads": [
    { "id": "l001", "name": "Lead 1" }
  ]
}