Create Purchase Session

Creates a purchase session for completing a purchase.

POST /payments/purchases/purchase-session

Create Purchase Session

cURL

curl --request POST \
  --url https://api.stack-auth.com/api/v1/payments/purchases/purchase-session \
  --header 'Content-Type: application/json' \
  --data '
{
  "full_code": "proj_abc123_def456ghi789",
  "price_id": "price_1234567890abcdef",
  "quantity": 1
}
'

200

{
  "client_secret": "1234567890abcdef_secret_xyz123"
}

Body

application/json

full_code · string · required

The verification code, given as a query parameter in the purchase URL

Example:

"proj_abc123_def456ghi789"

price_id · string · required

The Stack auth price ID to purchase

Example:

"price_1234567890abcdef"

quantity · number · default: 1

The quantity to purchase

Example:

1

Response

200 - application/json

Successful response

client_secret · string · required

The Stripe client secret for completing the payment

Example:

"1234567890abcdef_secret_xyz123"