Submit KYC
- POST /v3/b2b/kyc/onboard
Submitted KYC
Request Sample
curl --location --request POST 'https://test2-business-cgi.pingpongx.com/v3/b2b/kyc/onboard' \
--header 'Authorization: Bearer 8351e089d3df4dc7ac51d836f7788b32104616167cfd4dcaaf20e6e1285a909a' \
--header 'Content-Type: application/json' \
--header 'timestamp: 1637564397860' \
--header 'sign: 4a70672b69b59d24d1ef05b716b1fc1d89e3e87e2b4921cb5847b6230e91c472' \
--header 'app_id: 80242303107221' \
--data-raw '{
"open_id":"ffde6a4cb71047e2b5335fe03b23c793",
"subject_type": "INDIVIDUAL_OR_SOLE_PROPRIETORSHIP",
"modules":[
{
"module": "owner-info",
"materials": [
{
"material": "firstName",
"value": "First Name",
"material_type": "TEXT"
},
{
"material": "lastName",
"value": "Last Name",
"material_type": "TEXT"
},
{
"material": "birth",
"value": "Date of birth",
"material_type": "TEXT"
},
{
"material": "specifiedCity",
"value": "State / Province",
"material_type": "TEXT"
},
{
"material": "country",
"value": "Afghanistan",
"material_type": "TEXT"
},
{
"material": "city",
"value": "City",
"material_type": "TEXT"
},
{
"material": "nationality",
"value": "Afghanistan",
"material_type": "TEXT"
},
{
"material": "ssn",
"value": "Social Security Number",
"material_type": "TEXT"
},
{
"material": "drivingLicenseNo",
"value": "Driver's license number",
"material_type": "TEXT"
},
{
"material": "drivingLicense",
"value": "1021062211072502891351d9658n39",
"material_type": "FILE"
},
{
"material": "idType",
"value": "drivingLicense",
"material_type": "TEXT"
}
]
},
{
"module": "company-info",
"materials": [
{
"material": "businessUrl_1",
"value": "Business URL (Optional)",
"material_type": "TEXT"
},
{
"material": "category",
"value": "Baby products",
"material_type": "TEXT"
}
]
},
{
"module": "company-other-info",
"materials": [
{
"material": "address",
"value": "Address line 1",
"material_type": "TEXT"
},
{
"material": "otherAddress",
"value": "Address Line 2（Optional）",
"material_type": "TEXT"
},
{
"material": "city",
"value": "City",
"material_type": "TEXT"
},
{
"material": "state",
"value": "Alabama",
"material_type": "TEXT"
},
{
"material": "zipcode",
"value": "Postal / Zip code",
"material_type": "TEXT"
},
{
"material": "addressProof",
"value": "1021062211072502891351d9658n39",
"material_type": "FILE"
},
{
"material": "mobile",
"value": "Mobile",
"material_type": "TEXT"
}
]
}
]
}'
Request Schema
| Parameter | Type | Required | Description |
|---|---|---|---|
| subject_type | String | M | Subjec type(eg:INDIVIDUAL_OR_SOLE_PROPRIETORSHIP,PARTNERSHIP,CORPORATION,LIMITED_LIABILITY_COMPANY) |
| open_id | String | M | User ID in PingPong |
| modules | List | M | List of ModuleData |
ModuleData
| Parameter | Type | Required | Description |
|---|---|---|---|
| module | String | M | Module |
| materials | List | M | List of MaterialData |
MaterialData
| Parameter | Type | Required | Description |
|---|---|---|---|
| material | String | M | Material (If option has relate-materials, need to submit them also) |
| value | String | M | Material value (If the material type is FILE, use the file_id uploaded in the previous step, and if the material has optional values, use one of them) |
| material_type | String | M | Material type (eg: TEXT, FILE) |
Response Sample
{
"code": 0,
"success": true,
"message": "OK",
}