Create a customer session

Creates a customer session URL that can be used to redirect customers to the customer page. Returns the customer URL and session ID. The session is short-lived (15 minutes) for security reasons.

POST /v1/sdk/customers/customer-sessions

Create a customer session

cURL

curl --request POST \
  --url https://api.example.com/v1/sdk/customers/customer-sessions \
  --header 'Content-Type: application/json' \
  --data '
{
  "customerRef": "cus_3c4d5e6f7g8h"
}
'

201

{
  "customerUrl": "https://solvapay.com/customer/manage?id=e3f1c2d4b6a89f001122334455667788",
  "sessionId": "e3f1c2d4b6a89f001122334455667788"
}

Body

application/json

Customer session creation request data

customerRef · string · required

Minimum string length: 1

productRef · string

Response

201

application/json

Customer session created successfully

customerUrl · string · required

Full customer URL based on backend configuration (ready to redirect customer)

Example:

"https://solvapay.com/customer/manage?id=e3f1c2d4b6a89f001122334455667788"

sessionId · string · required

Customer session ID/token

Example:

"e3f1c2d4b6a89f001122334455667788"