Create order draft checkout session

Creates a Stripe Checkout Session for the current order-draft payment revision, or returns the existing open session when it still has enough remaining lifetime. Stale sessions are expired and superseded before a replacement is created.

POST /order_drafts/{id}/checkout_sessions

Create order draft checkout session

cURL

curl --request POST \
  --url https://api.akua.dev/v1/order_drafts/{id}/checkout_sessions \
  --header 'Authorization: Bearer <token>' \
  --header 'if-match: <if-match>'

201

{
  "id": "cs_test_...",
  "url": "<string>",
  "expires_at": 1
}

Authorizations

Authorization · string · header · required

workspace API token (sk_akua_...) or OAuth2 JWT. Create tokens at https://akua.dev/developers/api-tokens

Headers

if-match · string · required

The etag of the resource version the client last read. Required on writes when the resource exposes an etag field. Mismatch returns 409 ABORTED with the current etag in the error metadata.

Required string length: 1 - 256

Example:

"42"

Path Parameters

id · string · required

Order draft ID

Required string length: 1 - 55

Example:

"odft_j572abc..."

Response

201

application/json

Checkout session created or reused

id · string · required

Stripe Checkout Session ID

Example:

"cs_test_..."

url · string<uri> · required

Stripe-hosted Checkout URL

expires_at · integer · required

Unix timestamp (seconds)

Required range: x >= 0