Skip to main content
Verify Verification Code
curl --request POST \
  --url https://api.spherepay.co/v2/customer/{id}/otp-verify \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "email",
  "code": "123456"
}
'
{
  "customerId": "customer_f31121c389624d3697cbf3ea8830b7a4",
  "verifiedAt": "2026-03-09T20:46:31.305Z"
}
Verify an OTP code that was previously sent to a customer’s email address or phone number via the Send Verification Code endpoint. A successful response confirms that the customer controls the specified contact channel and advances their KYC verification criteria. If the code is expired or incorrect, send a new code and prompt the customer to try again.

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

Available options:
phone,
email
Example:

"email"

​
code
string
required

Verification code

Required string length: 1 - 10
Example:

"123456"

Response

​
customerId
string
required

Customer ID

Example:

"customer_f31121c389624d3697cbf3ea8830b7a4"

​
verifiedAt
string
required

ISO 8601 formatted date and time of the verification code verification

Example:

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

Last modified on June 18, 2026