Add User Verification

Testing Env

https://partner-api-stage.p100.io

POST

/v1/user/verification

This endpoint initiates the asynchronous Know Your Customer (KYC) verification process. It should be invoked only after all required user documents have been successfully uploaded.

The verification is handled asynchronously, and upon its successful completion, the system dispatches a user.status.changed webhook. This event serves as the definitive confirmation that the user's balances are now ACTIVE and all platform functionalities have been unlocked.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://partner-api-stage.p100.io/v1/user/verification' \
--header 'Content-Type: application/json' \
--header 'x-api-key;' \
--data-raw '{
  "externalUserId": "6ef2fb57-c337-4557-ba24-b82f1322f911",
  "birthDate": "2000-01-01",
  "city": "London",
  "street": "Downing Street",
  "number": "10",
  "postCode": "SW1A 2AA",
  "nationality": "GB",
  "documentExpirationDate": "2030-01-01",
  "incomeSource": "SALARY",
  "occupation": "IT",
  "riskLvl": "LOW"
}'

Response Example

201 - Success

{
    "message": "Verification documents to user added successfully"
}

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Body Params application/json

Examples

Responses

🟢201Created

application/json

Body

🟠401Access Denied

🟠400P403: Validation error

🟠400P412: User not exist

🟠400P430: Too many verifications

🟠400P442: User already verified

🟠400P444: POA rejected

🟠400P446: KYC is not valid or expired

🟠400P447: POA already verified

🟠404P427: Missing KYC files

🟢202P210: POA file not yet uploaded

🟢202P211: POA pending

🟠400P500: Unknown exception

🟠400P501: Service temporarily unavailable

Add POA File

Update Existing User