Website
Checkout Flow
Orchestrate the checkout process: cart snapshot, customer details, payment creation, and completion with automatic order + stock + email. Works with Stripe and Mollie for payments.
Endpoints (8)
Start a checkout from a cart. Snapshots cart items and totals. Returns checkout_token. Idempotent: returns existing active checkout if one exists for this cart.
No input parameters required.
Set customer details and shipping/billing address. Recalculates total if shipping or tax costs are provided.
No input parameters required.
Create a payment for an active checkout. With provider "mollie"/"stripe" the provider is called server-side (vault keys never leave the server) and a redirect URL is returned. With provider "invoice" no online payment is created (deferred / "op factuur"): the checkout becomes completable and the resulting order gets status "pending" / payment_status "unpaid". Invoice mode requires the project setting allow_invoice_checkout.
No input parameters required.
Link an external payment to the checkout. Use create-payment instead for automatic payment creation. This endpoint is for manual linking only.
No input parameters required.
Get the full checkout state including items, customer, payment, and totals.
No input parameters required.
Attach validated typed meta (e.g. a contact-lens prescription) to a checkout line, identified by product_sku and bound to the checkout token. Values are validated server-side against the meta definition + its config source, stored on the checkout, and promoted to the order line on completion.
No input parameters required.
Complete the checkout after payment. Marks as paid, creates order, decrements stock, sends confirmation email. Idempotent: safe to call multiple times.
No input parameters required.
Cancel a checkout. Cart remains active and can be used for a new checkout.
No input parameters required.
MCP Tool Names
When using this integration through an AI assistant (Claude, ChatGPT, Cursor, etc.), the endpoints are available as MCP tools:
| Endpoint | MCP Tool Name |
|---|---|
| initiate-checkout | checkout-flow_initiate_checkout |
| set-customer | checkout-flow_set_customer |
| create-payment | checkout-flow_create_payment |
| set-payment | checkout-flow_set_payment |
| get-checkout-status | checkout-flow_get_checkout_status |
| set-line-meta | checkout-flow_set_line_meta |
| complete-checkout | checkout-flow_complete_checkout |
| cancel-checkout | checkout-flow_cancel_checkout |