Skip to main content

Overview

Checkout is a 3-step flow:
  1. estimate totals → 2) collect/validate shipping address → 3) create an invoice.

Authentication

Merchant checkout routes require x-commerce-api-key.

Request

Estimate checkout

Submit address

Create invoice

Response

Example invoice response (truncated):
Notes:
  • Commerce invoices expire after ~30 minutes (expiresAt in the response).
  • Create a new invoice for every checkout attempt or retry; do not reuse expired or failed invoices.

Errors

  • 400 invalid checkout/address payload
  • 401 missing/invalid commerce API key
  • 409 idempotency conflict on invoice creation

Examples

  • Treat invoice creation as a write: always pass an Idempotency-Key when calling the API directly. Next: Orders