Send One-Time Passcode

POST 
/wallet-registration/otp

This endpoint generates a 6-digit OTP and sends it to the user contact (email or phone number SMS) provided in the request body, as long as it matches the receiver contact info stored in the SDP. A valid SEP-24 token should be included in this request's Authorization header.

Request

Header Parameters

Authorization stringrequired

SEP-24 token for authorization (Format: 'Bearer {token}')

application/json

Body

required

Object containing phone number

phone_number string

Phone number to which the OTP will be sent. Either phone_number or email is required.

email string

Email to which the OTP will be sent. Either phone_number or email is required.

recaptcha_token stringrequired

Token for reCAPTCHA validation

Responses

200

OTP sent successfully

application/json

Schema

Schema

message stringrequired

Example (from schema)

{
  "message": "string"
}

400

Bad Request

application/json

Schema

Schema

error string

Details about the error

extras

object

object

Example (from schema)

{
  "error": "Invalid input",
  "extras": {
    "field_foo": "field_foo is required",
    "field_bar": "field_bar needs to be an integer"
  }
}

401

Unauthorized

application/json

Schema

Schema

error string

extras

object

status number

message string

Example (from schema)

{
  "error": "Not authorized",
  "extras": {
    "status": 401,
    "message": "Not authorized"
  }
}

Example

{
  "error": "Not authorized",
  "extras": {
    "status": 401,
    "message": "Not authorized"
  }
}

429

An OTP was sent to the given user recently and hasn't expired yet. Only after expired it will be sent to the user again.

application/json

Schema

Schema

error string

extras

object

code string

details string

Example (from schema)

{
  "error": "string",
  "extras": {
    "code": "string",
    "details": "string"
  }
}

Loading...