Create Payment Intent

Checkout

Create a Stripe PaymentIntent for the authenticated clinic to pay invoices or an order basket. Clinic-only. Prices are resolved from the lab catalog.

Authorization

__Secure-guidelab-prod.session_token<token>

Production session cookie set for the guidelab.co domain by Better Auth

In: cookie

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

labId*string

Lab ID to pay

Length1 <= length

idempotencyKey*string

Stable key for this payment attempt; reuse it only for an exact retry

Length8 <= length <= 200

invoiceIds?array<>

Items1 <= items <= 20

items?array<>

Items1 <= items <= 100

draftOrderId?string

Length1 <= length <= 128

Response Body

`application/json`

curl -X POST "https://example.com/checkout/create-payment-intent" \  -H "Content-Type: application/json" \  -d '{    "labId": "string",    "idempotencyKey": "stringst"  }'

{  "clientSecret": "string",  "paymentIntentId": "string",  "amount": 0,  "amountDisplay": "string",  "currency": "string",  "status": "string",  "convertedOrderId": "string",  "taxAmount": "string",  "taxMode": "none",  "taxIncludedInPrices": true}

{  "error": "string",  "details": {    "code": "payment_amount_exceeds_provider_limit",    "maxMinor": "99999999",    "currency": "string"  }}

Empty

Confirm Checkout Payment POST

Verify that a Stripe PaymentIntent has succeeded after the client-side payment flow completes. Clinic-only. Used as a server-side confirmation step before updating order/invoice status.

Clients

Create Payment Intent

Authorization

Request Body

Response Body

200application/json

400application/json

409

500

`application/json`

`application/json`