Abandoned Cart - Zid Docs

AbandonedCartDetailed

This schema provides a detailed representation of an abandoned cart. An abandoned cart is a shopping cart where items have been added but the purchase has not been finalized. The cart is considered abandoned after **10 minutes** of inactivity. This schema outlines all the relevant information about the cart, the customer, and the products involved.

status

string

optional

The status of the request.

Example:

object

abandoned_cart

object

optional

Details of the abandoned cart.

string

optional

Unique identifier for the abandoned cart.

Example:

18a40fc6-2381-4ab2-9f72-467e6c39a599

url

string

optional

URL to access the abandoned cart and continue the checkout process. This is crucial for re-engaging customers.

Example:

https://store.zidtest.com/checkout/fromBasket/WS56eLg6j2J2KAFB6KkX0B3uJSs3oINu

store_id

string

optional

Unique identifier for the store.

Example:

3dfc16e6-ad19-4126-9c2a-5e4a7fb73051

store_name

string

optional

Name of the store.

Example:

Zid Store on Testing

store_logo

string

optional

URL of the store's logo.

Example:

https://zid-testing.s3.eu-west-1.amazonaws.com/3dfc16e6-ad19-4126-9c2a-5e4a7fb73051/d24a04a4-483c-4cfd-937e-35e7f419d127-200x.png

store_url

string

optional

URL of the store.

Example:

https://store.zidtest.com/

products_count

integer

optional

Number of products in the abandoned cart.

Example:

products

array [object {14}]

optional

List of products in the abandoned cart.

city

object (City)

optional

history

array [object {5}]

optional

History of actions related to the abandoned cart.

phase

string

required

Current phase of the abandoned cart. This indicates the last step the customer reached before abandoning the cart.
The phases are as follows:

completed: The cart has been converted into an order.

shipping_address: The customer has provided a shipping address.

verification: The customer is in the verification process.

shipping_method: The customer has chosen a shipping method.

new: The cart has been recently created but no further action has been taken.

login: The customer is prompted to log in or register.

payment-method: The customer has selected a payment method but has not completed the purchase.

Example:

payment_method

customer_id

string

required

A unique identifier for the customer.

Example:

000000000

customer_name

string

required

The full name of the customer.

Example:

test customer name

customer_email

string

required

The email address of the customer.

Example:

testemail@gmail.com

customer_mobile

string

required

The customer's mobile phone number.

Example:

966555555555

reminders_count

string

required

The number of reminders sent to the customer regarding the transaction or payment.

Example:

cart_total

string

required

The total cost of items in the cart, represented as a floating-point number.

Example:

239.00

cart_total_string

string

required

The total cost of items in the cart, formatted as a string with the currency (e.g., "SAR").

Example:

239.00 SAR

created_at

string <date-time>

optional

Timestamp when the cart was created.

Example:

2023-07-12 08:17:02

updated_at

string <date-time>

optional

Timestamp when the cart was last updated.

Example:

2023-07-19 09:01:18

source

string

required

Indicating the source or channel of the order. This can be one of several predefined values:

catalog: Order was made through a product catalog or online storefront.

mobile_app: Order was made through the store's mobile application.

Example:

catalog

message

object

optional

Message related to the request status.

type

string

optional

Type of the message.

Example:

object

code

string

optional

Code associated with the message.

name

string

optional

Name of the message.

description

string

optional

Detailed description of the message.