1. Change mobile number from profile settings
Vrtx Docs
  • 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
  • Webhooks
    • Process Nafath webhook
      POST
    • Process Faceki webhook
      POST
    • Process T2 webhook
      POST
  • Wallet
    • Change mobile number from profile settings
      • Change mobile number
        POST
      • Verify mobile number change OTP
        POST
      • Get mobile change status
        GET
    • Change mobile number from login screen
      • Change mobile number
      • Verify mobile number change OTP
      • Initiate Nafath
      • Get mobile number change status
  • Businesses
    • Create business
      POST
  • Transactions
    • Business Accounts
      • Get business account balance
      • Get transaction details
      • List business transactions
    • Wallet Accounts
      • Get wallet balance
      • List wallet transactions
  • 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
  • cards
    • Initiate card replacement
    • Verify OTP and complete card replacement
Open-Loop-v2Closed-loop V2Card Simulatoropen-loop-test
Open-Loop-v2Closed-loop V2Card Simulatoropen-loop-test
  1. Change mobile number from profile settings

Change mobile number

POST
/profile/change-mobile-number
Last modified:2025-12-02 10:06:51
Allows an existing user who is LOGGED IN to change the mobile number linked to their wallet account.
This endpoint initiates the mobile number change process by:
1.
Validating the customer exists using the provided customer ID
2.
Verifying ownership of the new mobile number through Yakeen
3.
Sending an OTP to the new mobile number
4.
Starting a session that will require:
OTP verification
The process ensures secure transfer of the account to a new mobile number in compliance with SAMA requirements.
Rate Limiting: Users can only change their mobile number once per 24-hour period.
Important: This API handles the initial request. Additional endpoints will be needed for:
OTP verification
Status checking

Request

Body Params application/jsonRequired

Examples

Responses

🟢200Success
application/json
Default Response
Body

đźź 400400
đźź 401401
đźź 403403
đźź 404404
đźź 405405
đźź 409409
đźź 410410
đźź 422422
đźź 429429
đź”´500500
đź”´501501
đź”´503503
đź”´504504
đź”´505505
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/profile/change-mobile-number' \
--header 'Content-Type: application/json' \
--data-raw '{
    "customer_id": "c1d2e3f4-a5b6-7890-c1d2-e3f4a5b6c7d8",
    "new_mobile_number": "966501234567",
    "locale": "ar"
}'
Response Response Example
200 - Example 1
{
    "session_id": "1ffd059c-17ea-40a8-8aef-70fd0307db82",
    "customer_id": "160c0c4b-9966-4dc1-a916-8407eb10d74e",
    "status": "PENDING_MOBILE_NUMBER_OWNERSHIP_VERIFICATION"
}
Modified at 2025-12-02 10:06:51
Previous
Process T2 webhook
Next
Verify mobile number change OTP
Built with