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 (7)
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 via Mollie or Stripe for an active checkout. Calls the payment provider server-side (vault keys never leave the server). Returns a redirect URL for the customer to complete payment.
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.
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 |
| complete-checkout | checkout-flow_complete_checkout |
| cancel-checkout | checkout-flow_cancel_checkout |