Skip to main content
POST
Start a wallet session

Authorizations

Authorization
string
header
required

Use Authorization: Bearer <identity token> - a single-use, short-lived token identifying the customer, issued by your own sign-in.

Body

application/json
publishable_key
string
required

The publishable key of the site the wallet is embedded in.

Minimum string length: 1

Response

The session was started.

token
string
required

Credential the wallet presents to establish the customer's session.

session_token
string
required

Credential the wallet presents when resolving an operation to sign.

expires_at
integer
required

Unix seconds at which session_token lapses. token is shorter-lived and the wallet refreshes it on its own; do not treat this as its expiry.

chain_id
integer
required

Network the session operates on.