Skip to main content
Send Verification Code
curl --request POST \
  --url https://api.spherepay.co/v2/customer/{id}/otp-send \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "email"
}
'
{
  "customerId": "customer_f31121c389624d3697cbf3ea8830b7a4",
  "expiresAt": "2026-03-09T20:46:31.305Z"
}
Send a one-time password (OTP) to a customer’s registered email address or phone number as part of contact verification during the KYC flow. After the code is sent, prompt the customer to enter it and then call the Verify OTP Code endpoint to confirm the contact detail. OTP codes expire at the time indicated by expiresAt in the response — if the code has expired before the customer submits it, call this endpoint again to send a new one.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string
required

Customer ID

Example:

"customer_f31121c389624d3697cbf3ea8830b7a4"

Body

application/json
​
type
enum<string>
required

Type of verification code to send

Available options:
phone,
email
Example:

"email"

Response

​
customerId
string
required

Customer ID

Example:

"customer_f31121c389624d3697cbf3ea8830b7a4"

​
expiresAt
string
required

ISO 8601 formatted date and time of the verification code expiration

Example:

"2026-03-09T20:46:31.305Z"

Last modified on June 18, 2026