Create Customer Session

Optty widgets require a session token to verify the source the Widget is loading from, and be able to display the correct list of available Payment Methods.

Parameters

Content Type: application/json

Create Customer Session

POST https://api.qa.optty.com/merchants/customer/sessions

For live environment, please update the endpoint to https://api.optty.com

Headers

Name	Type	Description
Authentication*	string	Authorization: Bearer <token>

Request Body

Name	Type	Description
customerIdentifier*	string	A unique identifier for a merchant’s customer. This can be the customer’s email address, or “anonymous” if it is a user not logged in.

200 Customer Session Created

{
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjdXN0b21lcklkZW50aWZpZXIiOiI2NDkzZDA3NTNmYjliNzBhNGY3YzFjYjE1ZTMwYzZjMmU1ZjE5Y2FlMWE1MGJiNTllMjRkMTYwMjIyOTcyMjgzMjA4OGJhZmRiMzAwNTA5MmQ4MTdjMzNhMTUyNzQyYjExZWMyZjJmYmJkYjlmN2FkYjFjMmMyMGQ3YzhjN2RiYyIsIm1lcmNoYW50SWQiOiI0NGFkMzIxMS0yYTgzLTRiNWUtYTJlNy03ZmZlNjhlZTkyMWMiLCJpYXQiOjE2MzM2ODM4NjksImV4cCI6MTYzNDI4ODY2OX0.4sTHdfV8aDJ26Lq1552cZIvpwwY6VPlBzoW2AGcAH8E",
    "ttl": 604800
}

Full Example

Sample Request

{
    "customerIdentifier":"anonymous"
}

Sample Curl Request

curl -X POST "https://api.staging.optty.com/merchants/customer/sessions" \
-H "accept: application/json" \
-H "Authorization: Bearer {YOUR ACCESS TOKEN}" \
-H "Content-Type: application/json" \
-d "{\"customerIdentifier\":\"anonymous\"}"

Sample Response

{
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjdXN0b21lcklkZW50aWZpZXIiOiI2NDkzZDA3NTNmYjliNzBhNGY3YzFjYjE1ZTMwYzZjMmU1ZjE5Y2FlMWE1MGJiNTllMjRkMTYwMjIyOTcyMjgzMjA4OGJhZmRiMzAwNTA5MmQ4MTdjMzNhMTUyNzQyYjExZWMyZjJmYmJkYjlmN2FkYjFjMmMyMGQ3YzhjN2RiYyIsIm1lcmNoYW50SWQiOiI0NGFkMzIxMS0yYTgzLTRiNWUtYTJlNy03ZmZlNjhlZTkyMWMiLCJpYXQiOjE2MzM5NDA2NzEsImV4cCI6MTYzNDU0NTQ3MX0.X5D3pbqMW_KbYA_SPpXAFwSD93Y60QE7i8CXF2Enw4c",
    "ttl": 604800
}