The Abandoned Checkout Recovery 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 and allows businesses to automate recovery actions such as follow-up emails, whatsapp messages, personalized notifications, or remarketing efforts. By leveraging this integration, brands can engage customers at the right moment and significantly improve checkout conversion rates.
A secret key used to verify that the webhook request originated from FlexyPe. Ensure this token is validated to prevent unauthorized access.
The version of the webhook payload. Here, the value will be 2025-09.
The unique identifier for the event that triggered this webhook.
Body The Shopify domain of the store (e.g., store.myshopify.com).
URL to redirect the user to FlexyPe Checkout.
The total discount applied to the entire cart, in the store’s currency.
The final amount the user has to pay after discounts and calculations.
The current status of the checkout session. This field reflects which step the user is on during their cart journey. 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.COMPLETED: Order has been successfully completed. List of products currently added to the user’s cart at the time of checkout. URL of the product image displayed to the user during checkout.
Title describing the selected product variant.
The discount amount applied to the item, in the store’s currency.
The price per unit of the item after applying any discounts.
The number of units of the product added to the cart.
Detailed information about the specific product variant selected. Descriptive label of the selected variant.
Price of the specific variant of the product.
Unique identifier assigned to this variant in Shopify.
The original price before discounts — shown as strikethrough on the UI.
Unique identifier for the base product in Shopify.
ID of the variant selected, same as variant.variant_id (duplicated for convenience).
Weight of the product variant in grams. Useful for shipping calculations.
The URL-friendly handle of the product, used in Shopify product URLs.
Total payable price for this item, calculated as price × quantity.
Total price for the item before any discounts are applied.
Cumulative discount applied to the item (if any).
Indicates whether the product has only one variant available (true/false).
The customer’s phone number used during checkout.
The country code associated with the user’s phone number.
The customer’s name used during checkout.
The customer’s email used during checkout.
An object representing the user’s address based on session_state Primary address line, typically containing street name, building number, or apartment name.
(Optional) Secondary address line, such as apartment number, suite, or additional details.
The city or locality of the user’s shipping or billing address.
Full name of the state or province associated with the address.
Full name of the country (e.g: “India”).
ISO 3166-2 code for the state (e.g: “GJ” for Gujarat).
ISO 3166-1 alpha-2 code for the country (e.g: “IN” for India).
Postal or ZIP code corresponding to the address.
The Shopify domain/subdomain for the merchant store.
Metadata about the client’s device and request. IP address of the client at the time of checkout initiation.
Referring URL from which the user was directed to the store.
User agent string from the user’s browser or device.
Data related to marketing and tracking attribution. Facebook Click ID (FBC) used for ad tracking. May be empty if unavailable.
Facebook browser ID (FBP) for retargeting and attribution.
Metadata captured from the user’s landing page and original source. This is typically used for attribution, analytics, and campaign performance tracking. An array of key–value pairs representing UTM and tracking parameters passed in the landing page URL. Allowed keys:
fbclid: Facebook Click IDgclid: Google Ads Click Identifierutm_medium: Type of marketing channelutm_source: Origin platformutm_campaign: Campaign name or identifierutm_content: Specific content or creative usedutm_term: Paid search keyword or targeting term Show UTM Parameter Properties
One of the allowed analytics parameter keys listed above.
The value associated with the given analytics parameter.
The original referrer URL from which the user landed on the store.
The host domain extracted from the original referrer URL.
The specific page path on the store where the user first landed.
{ "webhook_id" : "wh_123" , "shopify_domain" : "my-store.myshopify.com" , "cart_items" : [], "checkout_url" : "https://checkout.flexype.io/..." , "discount" : 0 , "total_payable" : 999 , "session_state" : "INITIATED" , "user" : { "phone_no" : "9876543210" , "dial_code" : "91" , "name" : "John Doe" , "email" : "[email protected] " , "address" : {} }, "store_link" : "https://my-store.com" , "coupons" : [], "client_meta" : { "client_ip" : "1.1.1.1" , "http_referer" : "" , "user_agent" : "" , "browser_fingerprint" : "" }, "analytics" : {}, "metadata" : {} }
