Abandoned Checkout Recovery

The Abandoned Checkout Recovery (ACR) Webhook is triggered whenever a checkout session is created or updated. It facilitates real-time synchronization of checkout data with external systems, enabling accurate tracking of active shopping sessions. This webhook plays a vital role in identifying potential checkout abandonment scenarios. An ACR event is sent 15 minutes after the checkout session opens, provided the order has not been completed. Once a session is marked as abandoned, returning to it does not trigger a new event. If the user opens a new checkout session, the previous session’s timer is cancelled and a new 15-minute timer starts from the new session’s open time. Businesses can use this event to automate recovery actions such as follow-up emails, WhatsApp messages, personalized notifications, or remarketing campaigns. By leveraging this integration, brands can engage customers at the right moment and significantly improve checkout conversion rates.

Headers

X-Flexype-Authorization

string

A secret key used to verify that the webhook request originated from FlexyPe. Ensure this token is validated to prevent unauthorized access.

X-Webhook-Version

string

The version of the webhook payload. Here, the value will be 2026-05.

X-Event-Id

string

The unique identifier for the event that triggered this webhook.

Body

event_time

string

The ISO 8601 timestamp when the event occurred.

event_type

string

The type of event. For this webhook, it is ABANDONED_CHECKOUT.

event_id

string

A unique identifier for the event.

store

object

Information about the store where the event occurred.

Show Store Properties

string

Unique identifier for the store.

name

string

Name of the store.

shopify_domain

string

The Shopify domain of the store (e.g., store.myshopify.com).

main_domain

string

The primary domain of the store.

payload

object

The event-specific data.

Show Payload Properties

session_id

string

The ID of the checkout session.

checkout_url

string

The URL to redirect the user to the FlexyPe checkout page.

checkout_context

object

Store and presentment context for the checkout.

Show Checkout Context Properties

store_country

string

The store’s country code.

store_currency

string

The store’s currency code.

presentment_country

string

The shopper’s presentment country code from the session.

presentment_currency

string

The shopper’s presentment currency code from the session.

user

object

Customer information captured during checkout.

Show User Properties

string

The customer’s email address.

full_name

string

The customer’s full name.

first_name

string

The customer’s first name.

last_name

string

The customer’s last name.

dial_code

string

The country dial code (e.g., 91).

phone

string

The customer’s phone number.

phone_with_dial_code

string

The phone number including the dial code.

cart_items

array

List of items in the cart.

Show Cart Item Properties

image

string

URL of the product image.

title

string

Title of the product.

discount

number

Discount amount applied to this item.

price

number

Price of the item after discounts.

quantity

number

Quantity of the item.

product_id

number

Shopify product ID.

variant_id

number

Shopify variant ID.

grams

number

Weight of the item in grams.

handle

string

Shopify product handle.

total_price

number

Total price for this item (price * quantity).

sub_total_price

number

Subtotal price before discounts.

total_discount

number

Total discount applied to this item.

single_variant

boolean

Whether the product has only one variant.

properties

array

Custom properties associated with the item.

variant

object

Variant details.

Show Variant Properties

title

string

Variant title.

price

number

Variant price.

variant_id

number

Variant ID.

compare_at_price

number

Original price before discount.

session_state

string

Current state of the checkout session. Possible values:

INITIATED: Cart session has been created but no user input has been provided.
PHONE_ENTERED: User has entered a phone number.
OTP_VERIFIED: User has successfully verified the OTP.
ADDRESS_LOADED: Address screen has been rendered or prefilled.
ADDRESS_SHIPPING_SELECTED: Shipping method has been selected after address submission.
PAYMENT_LOADED: Payment screen has been rendered.
PAYMENT_INITIATED: Payment has been initiated by the user.

coupons

array

List of applied coupons.

Show Coupon Properties

code

string

Coupon code.

discount_amount

number

Discount amount applied by this coupon.

client_meta

object

Metadata about the client’s device and request.

Show Client Meta Properties

client_ip

string

IP address of the client.

http_referer

string

HTTP referer URL.

user_agent

string

Browser user agent.

metadata

Metadata Object

Metadata captured from the user’s landing page and original source. This is typically used for attribution, analytics, and campaign performance tracking.

Show properties

utm

array

An array of key–value pairs representing UTM and tracking parameters passed in the landing page URL.Allowed keys:

fbclid: Facebook Click ID
gclid: Google Ads Click Identifier
utm_medium: Type of marketing channel
utm_source: Origin platform
utm_campaign: Campaign name or identifier
utm_content: Specific content or creative used
utm_term: Paid search keyword or targeting term

Show UTM Parameter Properties

name

string

One of the allowed analytics parameter keys listed above.

value

string

The value associated with the given analytics parameter.

orig_referer

string

The original referrer URL from which the user landed on the store.

referer_host

string

The host domain extracted from the original referrer URL.

landing_page

string

The specific page path on the store where the user first landed.

analytics

Analytics Object

Data related to marketing and tracking attribution.

Show properties

fb.fbp

string

Facebook browser ID (FBP) for retargeting and attribution.

{
  "event_time": "2026-05-07T10:00:00Z",
  "event_type": "ABANDONED_CHECKOUT",
  "event_id": "evt_123456789",
  "store": {
    "id": "store_01",
    "name": "My Awesome Store",
    "shopify_domain": "my-store.myshopify.com",
    "main_domain": "my-store.com"
  },
  "payload": {
    "session_id": "022eacfc-5a6a-4c7b-8a0a-6e9dc2ab196c",
    "checkout_url": "https://checkout.flexype.io/abc123xyz",
    "checkout_context": {
      "store_country": "IN",
      "store_currency": "INR",
      "presentment_country": "US",
      "presentment_currency": "USD"
    },
    "user": {
      "email": "[email protected]",
      "full_name": "John Doe",
      "first_name": "John",
      "last_name": "Doe",
      "dial_code": "91",
      "phone": "9876543210",
      "phone_with_dial_code": "+919876543210"
    },
    "cart_items": [
      {
        "image": "https://cdn.shopify.com/products/item.jpg",
        "title": "Cool T-Shirt",
        "discount": 0,
        "price": 999,
        "quantity": 1,
        "product_id": 12345,
        "variant_id": 67890,
        "grams": 200,
        "handle": "cool-t-shirt",
        "total_price": 999,
        "sub_total_price": 999,
        "total_discount": 0,
        "single_variant": true,
        "properties": [],
        "variant": {
          "title": "Large / Red",
          "price": 999,
          "variant_id": 67890,
          "compare_at_price": 1200
        }
      }
    ],
    "session_state": "PHONE_ENTERED",
    "coupons": [],
    "client_meta": {
      "client_ip": "1.1.1.1",
      "http_referer": "https://google.com",
      "user_agent": "Mozilla/5.0..."
    },
    "metadata": {
      "orig_referer": "https://google.com",
      "referer_host": "google.com",
      "landing_page": "/products/cool-t-shirt",
      "utm": []
    },
    "analytics": {
      "fb": {
        "fbp": "fb.1.12345.6789"
      }
    }
  }
}

Get Started

Platforms

Integrations

Webhooks

Abandoned Checkout Recovery

Headers

Body

​Headers

​Body

Headers

Body