Skip to main content
POST
/
api
/
v1
/
checkouts
Track Checkout Started
curl --request POST \
  --url https://api.sequenzy.com/api/v1/checkouts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "checkoutId": "<string>",
  "totalCents": 123,
  "currency": "<string>",
  "checkoutUrl": "<string>",
  "customer": {},
  "items": [
    {}
  ],
  "properties": {}
}
'
{
  "success": true,
  "checkoutId": "checkout-abc123",
  "subscriberId": "sub_abc123",
  "eventId": "evt_xyz789"
}
Track a started checkout from any e-commerce platform. Triggers the ecommerce.checkout_started event, which can power abandoned checkout automations (start a sequence on ecommerce.checkout_started with a delay, and stop it on ecommerce.order_placed).

​
Request Body

​
checkoutId
string
required
Unique checkout identifier in your platform.
​
totalCents
integer
Checkout total in cents.
​
currency
string
ISO 4217 currency code (e.g. USD).
​
checkoutUrl
string
URL the customer can use to resume the checkout. Available in emails as {{event.checkoutUrl}}.
​
customer
object
required
The customer who started the checkout. Requires email; also accepts externalId, firstName, lastName, and attributes.
​
items
array
Checkout line items. Each item has productId (required), title (required), quantity (required), variantId, sku, variantTitle, and priceCents.
​
properties
object
Extra event properties to attach to the triggered event.
curl -X POST "https://api.sequenzy.com/api/v1/checkouts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "checkoutId": "checkout-abc123",
    "totalCents": 8850,
    "currency": "USD",
    "checkoutUrl": "https://store.example.com/checkout/abc123",
    "customer": { "email": "buyer@example.com" },
    "items": [
      {
        "productId": "SKU-PROTEIN-1KG",
        "title": "Protein Powder",
        "quantity": 1,
        "priceCents": 8850
      }
    ]
  }'

​
Responses

{
  "success": true,
  "checkoutId": "checkout-abc123",
  "subscriberId": "sub_abc123",
  "eventId": "evt_xyz789"
}