​
Event Overview

The Checkout Completed event marks a successful sale. It is used to send order confirmations, thank-you messages, and start post-purchase engagement flows.

​
Use Cases

  • Order confirmation emails
  • First purchase welcome series
  • Payment method specific messaging
  • Guest account creation prompts
  • Cross-sell/upsell campaigns
  • Review request scheduling

​
Event Attributes

FieldTypeDescription
order_idstringUnique order identifier
order_numberstringHuman-readable order number
order_urlstringOrder details page URL
order_statusstringCurrent order status
checkout_idstringCheckout session identifier
cart_idstringShopping cart identifier
total_itemsintegerTotal line items
total_quantityintegerTotal product quantity
total_unique_itemsintegerNumber of unique products
subtotalnumberOrder subtotal before fees
discount_totalnumberTotal discount amount
shipping_costnumberShipping fee
tax_totalnumberTax amount
totalnumberFinal order total
currencystringCurrency code
coupon_codestringApplied coupon code
coupon_discountnumberCoupon discount amount
discount_percentagenumberTotal discount percentage
payment_methodstringPayment method used
payment_statusstringPayment status
transaction_idstringPayment transaction ID
shipping_methodstringShipping method
shipping_tierstringShipping speed tier
estimated_delivery_datestring (ISO 8601)Estimated delivery
tracking_numberstringShipment tracking number
tracking_urlstringTracking page URL
shipping_addressobjectDelivery address
billing_addressobjectBilling address
is_first_purchasebooleanFirst-time buyer
is_guest_checkoutbooleanGuest vs registered
productsarrayProducts ordered
checkout_durationintegerCheckout time (seconds)
order_sourcestringOrder origin
Order Status Values:
  • pending - Awaiting processing
  • confirmed - Order confirmed
  • processing - Being prepared
  • shipped - Order shipped
  • delivered - Successfully delivered
Payment Status Values:
  • paid - Payment successful
  • pending - Payment pending
  • failed - Payment failed

​
Payload Example

{
  "attributes": {
    "order_id": "ORD-001",
    "order_number": "1001",
    "order_url": "https://example.com/account/orders/ORD-001",
    "order_status": "confirmed",
    "checkout_id": "CHK-001",
    "cart_id": "CART-789",
    "total_items": 1,
    "total_quantity": 1,
    "total_unique_items": 1,
    "subtotal": 89.99,
    "discount_total": 0.00,
    "shipping_cost": 5.00,
    "tax_total": 7.20,
    "total": 102.19,
    "currency": "USD",
    "coupon_code": null,
    "coupon_discount": 0.00,
    "discount_percentage": 0,
    "payment_method": "credit_card",
    "payment_status": "paid",
    "transaction_id": "TXN-555666",
    "shipping_method": "FedEx Priority",
    "shipping_tier": "express",
    "estimated_delivery_date": "2026-02-08T18:00:00+05:30",
    "tracking_number": "TRK-000111",
    "tracking_url": "https://fedex.com/track/TRK-000111",
    "shipping_address": {
        "first_name": "John",
        "last_name": "Doe",
        "address_line1": "123 Main St",
        "address_line2": "Apt 4B",
        "city": "Mumbai",
        "state": "Maharashtra",
        "postal_code": "400001",
        "country": "India",
        "phone": "+910000000000"
    },
    "billing_address": {
        "first_name": "John",
        "last_name": "Doe",
        "address_line1": "123 Main St",
        "city": "Mumbai",
        "state": "Maharashtra",
        "postal_code": "400001",
        "country": "India",
        "phone": "+910000000000"
    },
    "is_first_purchase": true,
    "is_guest_checkout": false,
    "checkout_duration": 450,
    "order_source": "web_store",
    "products": [
      {
        "product_id": "PROD-123",
        "product_name": "Leather Boots",
        "sku": "BT-001",
        "price": 89.99,
        "quantity": 1,
        "total": 89.99,
        "product_url": "https://example.com/products/boots",
        "image_url": "https://example.com/images/boots.jpg"
      }
    ]
  }
}