Create Payment Widget Session

curl --request POST \
  --url https://api.example.com/session \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "storeId": "<string>"
}
'

{
  "data": {
    "expiresAt": "<string>",
    "token": "<string>"
  }
}

Session Management

Create Payment Widget Session

Creates a secure session token for payment widget integration. This endpoint is intended for merchant backends to generate session tokens that can be safely used by payment widgets in web applications. The session token provides secure access to payment methods without exposing sensitive merchant credentials.

Authentication Required: JWT Bearer token for merchant authentication Intended for: Merchant backend systems integrating payment widgets Security: Sessions are time-limited and scoped to specific stores

POST

session

curl --request POST \
  --url https://api.example.com/session \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "storeId": "<string>"
}
'

{
  "data": {
    "expiresAt": "<string>",
    "token": "<string>"
  }
}

Authorizations

Authorization

string

header

required

JWT token for merchant authentication. Format: "Bearer {your-jwt-token}"

Body

application/json

Session creation request containing store ID

storeId

string

required

Store UUID for which to create the session. Must be a valid UUID format. This identifies the merchant store that will use the payment widget. required: true example: "550e8400-e29b-41d4-a716-446655440000"

Response

Session successfully created with token and expiration

data

object

Session data containing the widget token and expiration information

Show child attributes

Retrieve Payment Method Types (Web Component)Refresh Payment Widget Session

Frontend

Backend

API Reference

Create Payment Widget Session

Authorizations

Body

Response