Skip to main content
POST
/
api
/
v1
/
elements
/
session
Create an ephemeral Elements session (publishable key + amount + currency)
curl --request POST \
  --url http://localhost:3001/api/v1/elements/session \
  --header 'Content-Type: application/json' \
  --data '
{
  "publishableKey": "pk_test_01HXYZ",
  "amount": 25.5,
  "currency": "usd"
}
'
{
  "success": true,
  "data": {
    "id": "<string>",
    "expiresInSeconds": 123
  }
}

Body

application/json
​
publishableKey
string
required

Publishable key (pk_test_* / pk_live_*) configured on the business profile

Example:

"pk_test_01HXYZ"

​
amount
number
required
Example:

25.5

​
currency
string
required
Example:

"usd"

Response

OK

​
success
boolean
required
Example:

true

​
data
object
required