HEhexclave
Payments

Create Purchase Session

Changed on

Creates a purchase session for completing a purchase.

post/payments/purchases/purchase-session

Request

  • Base URL
    https://api.hexclave.com/api/v1
  • URL
    https://api.hexclave.com/api/v1/payments/purchases/purchase-session
  • Auth
    none declared

Request body

full_codestring required

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

price_idstring required

The Hexclave price ID to purchase

quantityinteger

The quantity to purchase

Example request

{
  "full_code": "proj_abc123_def456ghi789",
  "price_id": "price_1234567890abcdef",
  "quantity": 1
}

Response

Successful response

client_secretstring

Stripe client secret used by the browser to confirm payment or setup via Stripe Elements. Omitted when no confirmation step is required from the customer.

stripe_intent_type'payment' | 'setup'

Whether client_secret is a PaymentIntent (immediate charge) or SetupIntent (e.g. free trial card collection). Omitted when client_secret is omitted.

Example response

{
  "client_secret": "1234567890abcdef_secret_xyz123",
  "stripe_intent_type": "payment"
}

Changes