Sample - Stripe API
POST/v1/terminal/connection_tokens

Create a Connection Token

To connect to a reader the Stripe Terminal SDK needs to retrieve a short-lived connection token from Stripe, proxied through your server. On your backend, add an endpoint that creates and returns a connection token.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.
  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

2 body fields
expandarray<string>optional
Specifies which fields in the response should be expanded.
locationstringoptional
The id of the location that this connection token is scoped to. If specified the connection token will only be usable with readers assigned to that location, otherwise the connection token will be usable with all readers. Note that location scoping only applies to internet-connected readers. For more details, see [the docs on scoping connection tokens](https://docs.stripe.com/terminal/fleet/locations-and-zones?dashboard-or-api=api#connection-tokens).

2 status codes
200Successful response.
locationstringoptional
The id of the location that this connection token is scoped to. Note that location scoping only applies to internet-connected readers. For more details, see [the docs on scoping connection tokens](https://docs.stripe.com/terminal/fleet/locations-and-zones?dashboard-or-api=api#connection-tokens).
objectstringrequired
String representing the object's type. Objects of the same type share the same value.
Allowed:terminal.connection_token
secretstringrequired
Your application should pass this token to the Stripe Terminal SDK.
defaultError response.
errorobjectrequired

Error handling

Any other status is an error: Error response.