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
  • Welcome 👋
  • Get Started
  • Auth
    • Token
      POST
  • 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
  • Wallet
    • Change mobile number from profile settings
      • Change mobile number
      • Verify mobile number change OTP
      • Get mobile change status
    • Change mobile number from login screen
      • Change mobile number
      • Verify mobile number change OTP
      • Initiate Nafath
      • Get mobile number change status
  • Payouts
    • Create payout
      POST
    • Get payout status
      GET
    • Create bulk payout
      POST
    • Get bulk payout status
      GET
    • Get batch report
      GET
  • Cards
    • Issuance
      • Issue card
      • Get card issuance
      • Complete card issuance
      • Verify card issuance OTP
      • Convert virtual to physical
      • Verify card conversion OTP
    • Management
      • Get card
      • Change card status
      • Set or update card PIN
      • Verify card PIN OTP
      • Activate physical card
      • Verify activation OTP
      • Display sensitive data
      • Verify display sensitive data OTP
  • Transactions
    • Business Accounts
      • Get business account balance
      • Get transaction details
      • List business transactions
    • Wallet Accounts
      • Get wallet balance
      • List wallet transactions
  • cards
    • Initiate card replacement
      POST
    • Verify OTP and complete card replacement
      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
Next
Change mobile number
Built with