Skip to main content
The OTP workflow consists of two API requests:
  1. Request an OTP
  2. Verify the OTP

​
Detailed flow

1

1. User enters their phone number

Your application collects the customer’s mobile number.
2

2. Request an OTP

Your application sends the phone number to the Beem OTP API.Beem validates the phone number before generating an OTP.
3

3. Receive the PIN ID

If the request is successful, Beem:
  • Generates a secure OTP
  • Creates a unique PIN ID
  • Sends the OTP via SMS
  • Returns the PIN ID in the API response
Save the PIN ID—it will be required during verification.
4

4. User receives the OTP

The customer’s mobile network delivers the SMS containing the OTP.
5

5. Verify the OTP

The user enters the received OTP into your application.Your application submits:
  • PIN ID
  • OTP
to the verification endpoint.
6

6. Receive the verification result

Beem verifies the OTP.If the OTP is valid and has not expired, the API returns a successful verification response.