Checkout

Create a human-completed checkout

Creates a checkout link on the Create Prints website for one or more completed, account-owned artworks. Every artwork must have an uploaded image and its aspect must match the selected variant. The agent returns checkoutUrl to the person, who reviews the basket and completes payment. A basket supports at most 20 line items; each line supports quantity 1–20. GB uses GBP and US uses USD. Multi-item or multi-quantity shipping is quoted before checkout; a temporary quote failure returns 503 with retryable: true.

post/api/checkout

Request

  • Base URL: https://api.createprints.ai
  • URL: https://api.createprints.ai/api/checkout
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.createprints.ai/api/oauth/authorize, token URL https://api.createprints.ai/api/oauth/token, scopes: checkout:create)

Headers

Idempotency-Keystring

Optional opaque key passed to checkout creation. Reuse it when retrying the same logical request.

Request body

OR

Response

Checkout was created.

code'ok' required
checkoutUrlstring uri required

Create Prints website URL for human review and payment.

checkoutSessionIdstring required
basketIdstring uuid
jobIdstring uuid
productVariantIdstring uuid
productAmountCentsinteger
shippingAmountCentsinteger
totalAmountCentsinteger
currency'GBP' | 'USD' required
productAmountFormattedstring
shippingAmountFormattedstring
totalAmountFormattedstring

Changes

No recorded changes to this operation across all 1 revision of this API.