API reference | Creativemark Developers

POST /api/v1/stores/<store_slug>/checkout/session/

Creates a signed checkout session and returns a URL to redirect customers to. This is the primary integration method for CMS and e-commerce platforms.

Request Headers

Authorization: Bearer <your_store_api_key>
Content-Type: application/json

Request Body

{
  "items": {
    "PRODUCT-SKU-1": 1,
    "PRODUCT-SKU-2": 2
  },
  "currency": "GBP",
  "locale": "en",
  "external_reference": "your-order-123",
  "return_url_success": "https://your-site.example/success",
  "return_url_cancel": "https://your-site.example/cancel"
}

Response (200 OK, selected fields)

{
  "token": "abc123...",
  "checkout_url": "https://creativemark.co/s/your-store/cart/?token=abc123...",
  "expires_at": "2026-03-02T12:00:00Z"
}

cURL

curl -X POST \
  https://creativemark.co/api/v1/stores/your-store/checkout/session/ \
  -H "Authorization: Bearer $CREATIVEMARK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"items": {"YOUR-PRODUCT-SKU": 1}, "currency": "GBP"}'

Python

import os
import requests

resp = requests.post(
    "https://creativemark.co/api/v1/stores/your-store/checkout/session/",
    headers={"Authorization": f"Bearer {os.environ['CREATIVEMARK_API_KEY']}"},
    json={
        "items": {"YOUR-PRODUCT-SKU": 1},
        "currency": "GBP",
    },
    timeout=30,
)
resp.raise_for_status()
data = resp.json()
checkout_url = data["checkout_url"]

Checkout