vrtx Docs
Core APIs
  • Start
  • Onboarding
  • Wallet
  • Payouts
  • Cards
  • Transactions
Closed loop APIsCard Simulator
SDK APIs
  • Coming Soon!
Core APIs
  • Start
  • Onboarding
  • Wallet
  • Payouts
  • Cards
  • Transactions
Closed loop APIsCard Simulator
SDK APIs
  • Coming Soon!
  1. Onboarding
  • Start onboarding
    POST
  • Verify onboarding OTP
    POST
  • Resend onboarding OTP
    POST
  • Get session status
    GET
  • Initiate Nafath
    POST
  • Cancels session
    POST
  • Complete customer info
    POST
  1. Onboarding

Complete customer info

POST
https://api.staging.vrtx.sa/onboarding/complete-customer-information
Last modified:2025-12-03 10:51:05
Collects full KYC information including professional, financial, and compliance details for the final step of user onboarding.
This endpoint validates PEP status, employment information, and income details according to SAMA compliance requirements.
Returns success confirmation with submission status when all validations pass.

Request

Authorization
JWT Bearer
Add the parameter
Authorization
to Headers
Example:
Authorization: ********************
or
Body Params application/jsonRequired

Example
{
    "customer_id": "160c0c4b-9966-4dc1-a916-8407eb10d74e",
    "occupation_class": "WORKER",
    "occupation": "ENGINEER",
    "employer_name": "string",
    "income_source": "SALARY",
    "monthly_income_range": "RANGE_0_TO_4999",
    "politically_exposed": true,
    "pep_relation": "MYSELF"
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.staging.vrtx.sa/onboarding/complete-customer-information' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "customer_id": "160c0c4b-9966-4dc1-a916-8407eb10d74e",
    "occupation_class": "WORKER",
    "occupation": "ENGINEER",
    "employer_name": "string",
    "income_source": "SALARY",
    "monthly_income_range": "RANGE_0_TO_4999",
    "politically_exposed": true,
    "pep_relation": "MYSELF"
}'

Responses

🟢200OK
application/json
Default Response
Body

Example
{
    "customer_id": "160c0c4b-9966-4dc1-a916-8407eb10d74e"
}
🟠400Bad Request
🟠401Unauthorized
🔴503Service Unavailable
Modified at 2025-12-03 10:51:05
Previous
Cancels session
Built with