1. Management
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
      • 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
  • 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
    • Get payout status
    • Create bulk payout
    • Get bulk payout status
    • Get batch report
  • 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
        GET
      • Change card status
        PATCH
      • Set or update card PIN
        POST
      • Verify card PIN OTP
        POST
      • Activate physical card
        POST
      • Verify activation OTP
        POST
      • Display sensitive data
        POST
      • Verify display sensitive data OTP
        POST
  • 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. Management

Verify activation OTP

POST
/cards/activate/verify-otp
Last modified:2025-12-02 10:06:51
Confirms a physical card activation by verifying the OTP sent during the initiate step.
Provide the session_id returned earlier along with the OTP to complete activation.
Request:
session_id: Activation session identifier
otp: 4 digit OTP sent to the user
idempotency-key: Unique key to ensure idempotent requests
Response:
card_status: Resulting status of the card after activation is confirmed
Error Responses:
404 CARD_NOT_FOUND/CARD_ISSUANCE_NOT_FOUND: Card or activation session missing
412 CARD_EXPIRED/ACTIVATION_NOT_ALLOWED: Card expired or not allowed to activate
400 ACTIVATION_FAILED: OTP validation failed or activation could not finish
503 SERVICE_UNAVAILABLE: Backend temporarily unavailable

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200Success
application/json
Default Response
Body

đźź 400400
đźź 401401
đźź 403403
đźź 404404
đźź 405405
đźź 409409
đźź 410410
đźź 412412
đźź 422422
đźź 429429
đź”´500500
đź”´501501
đź”´503503
đź”´504504
đź”´505505
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/cards/activate/verify-otp' \
--header 'idempotency-key;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "session_id": "f1e2d3c4-b5a6-7890-c1d2-e3f4a5b6c7d8",
    "otp": "5678"
}'
Response Response Example
200 - Success
{
    "card_status": "ACTIVE"
}
Modified at 2025-12-02 10:06:51
Previous
Activate physical card
Next
Display sensitive data
Built with