Queries
checkoutSession
Fetch a checkout session with payment and order details.
Mutations
createCheckoutSession
Create a checkout session from a cart.
| Field | Type | Required | Description |
|---|---|---|---|
cartUid | UUID | Yes | Cart to check out |
guestEmail | String | No | Email for guest checkout |
guestName | String | No | Name for guest checkout |
updateCheckoutSession
Update checkout details (address, payment provider, shipping).
| Field | Type | Description |
|---|---|---|
selectedPaymentProvider | String? | Payment provider ID |
customer | CustomerInfoInput? | Customer email, name, phone |
billingAddress | AddressInput? | Billing address |
shippingAddress | AddressInput? | Shipping address |
selectedShippingOption | String? | Shipping option UID |
completeCheckoutSession
Complete payment and finalize the order.
Types
CheckoutSession
| Field | Type | Description |
|---|---|---|
uid | UUID | Session ID |
status | OPEN | COMPLETED | EXPIRED | ABANDONED | Session status |
checkoutUrl | String | Hosted checkout URL |
readyForPayment | Boolean | Whether all required fields are set |
requiredFields | [String] | BILLING_ADDRESS, SHIPPING_ADDRESS |
checkoutValidationIssues | [String] | Validation errors preventing completion |
selectedPaymentProvider | String? | Selected provider ID |
shippingOptions | [ShippingOption] | Available shipping options |
paymentSession | PaymentSession? | Payment provider session |
order | Order? | Associated order |
invoice | Invoice? | Associated invoice |
expiresAt | DateTime | Session expiry |
completedAt | DateTime? | Completion timestamp |
PaymentSession
| Field | Type | Description |
|---|---|---|
uid | UUID | Session ID |
provider | String | Provider ID (e.g. stripe-payment-gateway) |
status | READY | PENDING | FAILED | Payment status |
amount | Int | Amount in minor currency units (cents) |
currency | String | ISO currency code |
providerRef | String? | Provider reference (e.g. Stripe PaymentIntent ID) |
clientToken | String? | Client-side token for embedded payment flows |
paymentMethods | [String] | CARD, APPLE_PAY, GOOGLE_PAY, PAYPAL, KLARNA, AMAZON_PAY, LINK |
ShippingOption
| Field | Type | Description |
|---|---|---|
uid | String | Option ID |
displayName | String | Display name |
amount | Int | Cost in minor currency units (cents) |
AddressInput
| Field | Type |
|---|---|
line1 | String? |
line2 | String? |
city | String? |
state | String? |
postalCode | String? |
country | String? |