Send a phone verification code to a customer

curl --request POST \
  --url https://api.lightspark.com/grid/2025-10-13/customers/{customerId}/verify-phone \
  --header 'Authorization: Basic <encoded-value>'

{
  "status": 401,
  "message": "<string>",
  "details": {}
}

Contact Verification

Send a phone verification code to a customer

Send (or resend) a one-time code via SMS to the customer’s phone number to begin phone verification.

This endpoint is only meaningful for customers whose payment provider requires contact verification (e.g. EU customers); the customer’s contactVerification.phone status reflects progress. For customers whose provider has no such requirement, this returns 409.

Call POST /customers/{customerId}/verify-phone/confirm with the received code to complete verification. Re-POST this endpoint to resend the code.

In sandbox, no SMS is sent and the code is always 123456.

POST

customers

{customerId}

verify-phone

Send a phone verification code to a customer

curl --request POST \
  --url https://api.lightspark.com/grid/2025-10-13/customers/{customerId}/verify-phone \
  --header 'Authorization: Basic <encoded-value>'

{
  "status": 401,
  "message": "<string>",
  "details": {}
}

Authorizations

Authorization

string

header

required

API token authentication using format <api token id>:<api client secret>

Path Parameters

customerId

string

required

The Grid customer ID to send a phone verification code to.

Response

Verification code sent.

Confirm a customer's email verification code

Confirm a customer's phone verification code

⌘I