Wallet PIN

To safeguard sensitive on-chain interactions (such as reward claiming, off-ramping, or token transfers), users must configure a 4-to-6-digit security PIN.

Set Wallet PIN

Sets an initial security PIN on the user’s account.

Endpoint

POST /api/v2/auth/set-wallet-pin

Headers

Authorization: Bearer <jwt_access_token>

Request Body

Field	Type	Required	Description
`pin`	`string`	Yes	4-6 digit numeric string

{
  "pin": "1234"
}

Response (200 OK)

{
  "success": true,
  "message": "Wallet PIN set successfully"
}

Verify Wallet PIN

Verifies the user’s entered PIN before initiating a secure transaction.

Endpoint

POST /api/v2/auth/verify-wallet-pin

Headers

Authorization: Bearer <jwt_access_token>

Request Body

Field	Type	Required	Description
`pin`	`string`	Yes	User’s numeric security PIN

{
  "pin": "1234"
}

Response (200 OK)

{
  "success": true,
  "data": {
    "verified": true,
    "pinToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
  },
  "message": "Wallet PIN verified"
}

Reset Wallet PIN

Allows requesting and confirming a PIN reset via email OTP verification.

Endpoints

POST /api/v2/auth/reset-wallet-pin-otp – Sends PIN reset OTP to user email.
POST /api/v2/auth/verify-wallet-pin-reset-otp – Verifies OTP and sets new PIN.

{
  "otpCode": "492019",
  "newPin": "5678"
}

​Wallet PIN

​Set Wallet PIN

​Endpoint

​Headers

​Request Body

​Response (200 OK)

​Verify Wallet PIN

​Endpoint

​Headers

​Request Body

​Response (200 OK)

​Reset Wallet PIN

​Endpoints

Wallet PIN

Set Wallet PIN

Endpoint

Headers

Request Body

Response (200 OK)

Verify Wallet PIN

Endpoint

Headers

Request Body

Response (200 OK)

Reset Wallet PIN

Endpoints