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

string

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

string

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

string

The unique identifier for the event that triggered this webhook.

Body

string

The ISO 8601 timestamp when the event occurred.

string

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

string

A unique identifier for the event.

object

Information about the store where the event occurred.

Show Store Properties

string

Unique identifier for the store.

string

Name of the store.

string

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

string

The primary domain of the store.

object

The event-specific data.

Show Payload Properties

string

The ID of the checkout session.

string

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

object

Store and presentment context for the checkout.

Show Checkout Context Properties

string

The store’s country code.

string

The store’s currency code.

string

The shopper’s presentment country code from the session.

string

The shopper’s presentment currency code from the session.

object

Customer information captured during checkout.

Show User Properties

string

The customer’s email address.

string

The customer’s full name.

string

The customer’s first name.

string

The customer’s last name.

string

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

string

The customer’s phone number.

string

The phone number including the dial code.

array

List of items in the cart.

Show Cart Item Properties

string

URL of the product image.

string

Title of the product.

number

Discount amount applied to this item.

number

Price of the item after discounts.

number

Quantity of the item.

number

Shopify product ID.

number

Shopify variant ID.

number

Weight of the item in grams.

string

Shopify product handle.

number

Total price for this item (price * quantity).

number

Subtotal price before discounts.

number

Total discount applied to this item.

boolean

Whether the product has only one variant.

array

Custom properties associated with the item.

object

Variant details.

Show Variant Properties

string

Variant title.

number

Variant price.

number

Variant ID.

number

Original price before discount.

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.

array

List of applied coupons.

Show Coupon Properties

string

Coupon code.

number

Discount amount applied by this coupon.

object

Metadata about the client’s device and request.

Show Client Meta Properties

string

IP address of the client.

string

HTTP referer URL.

string

Browser user agent.

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

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

string

One of the allowed analytics parameter keys listed above.

string

The value associated with the given analytics parameter.

string

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

string

The host domain extracted from the original referrer URL.

string

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

Analytics Object

Data related to marketing and tracking attribution.

Show properties

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

Features

Platforms

Integrations

Webhooks

Miscellaneous

Abandoned Checkout Recovery

Headers

Body

​Headers

​Body

Headers

Body