OTP Verification

LearnWay issues cryptographically random 6-digit one-time passwords (OTP) sent via Resend email service with a default 10-minute expiry time.

Send OTP

Dispatches an OTP to a target email address.

Endpoint

POST /api/v2/auth/send-otp

Request Body

Field	Type	Required	Description
`email`	`string`	Yes	Destination email address
`purpose`	`string`	No	Purpose of OTP: `SIGNUP`, `LOGIN`, `PASSWORD_RESET`, `WALLET_PIN_RESET` (Default: `LOGIN`)

{
  "email": "learner@example.com",
  "purpose": "SIGNUP"
}

Response (200 OK)

{
  "success": true,
  "data": {
    "email": "learner@example.com",
    "expiresInSeconds": 600
  },
  "message": "OTP code has been sent successfully"
}

Verify OTP

Validates that an entered OTP code matches the issued token and has not expired.

Endpoint

POST /api/v2/auth/verify-otp

Request Body

Field	Type	Required	Description
`email`	`string`	Yes	User email address
`otpCode`	`string`	Yes	6-digit numeric OTP code
`purpose`	`string`	No	Matching purpose used when sending

{
  "email": "learner@example.com",
  "otpCode": "592014",
  "purpose": "SIGNUP"
}

Response (200 OK)

{
  "success": true,
  "data": {
    "verified": true,
    "email": "learner@example.com"
  },
  "message": "OTP verified successfully"
}