Place a new order from the abandoned cart
If you already have an abandoned cart left by a client, you can place it as an order with a Convert abandoned cart to order API call.
Such orders cannot be paid online, so we recommend using this method for pickup orders with in-store payment (offline payment methods) only.
Find abandoned cart ID
To place an order from the cart left by a customer, you need to find the abandoned cart ID.
If you know the customer's email, use the following example:
GET /api/v3/STOREID/carts?responseFields=items(cartId,createTimestamp,updateTimestamp)&email=EMAIL HTTP/1.1
Host: app.ecwid.com
Authorization: Bearer secret_token
Change STOREID
with your store ID, EMAIL
with the customer's email, and the secret_token
with the secret access token of your app.
In response, you'll receive a JSON with matching cart IDs and dateimes:
{
"items": [
{
"cartId": "B93F4091-E808-473D-8979-30438FC2157B",
"createTimestamp": 1724226729,
"updateTimestamp": 1724226729
},
{
"cartId": "DD440495-5F2D-4FEC-A554-C82DBB572BC0",
"createTimestamp": 1668073193,
"updateTimestamp": 1668080426
},
{
"cartId": "6BCD46F1-3F8D-4DAA-BB4C-D878CFA0381A",
"createTimestamp": 1623922316,
"updateTimestamp": 1623922316
}
]
}
If you can't identify a specific cart by the datetime, add more fields to responseFields
list or remove the param to get full cart details.
Find all supported query params for searching abandoned carts in the API reference.
Place an order using abandoned cart ID
Upon receiving the cartId
, use it to place the abandoned cart as an order with the following API call:
POST /api/v3/STOREID/carts/CARTID/place HTTP/1.1
Host: app.ecwid.com
Authorization: Bearer secret_token
Change STOREID
with your store ID, CARTID
with the abandoned cart ID received in the previous request, and the secret_token
with the secret access token of your app.
In response, you'll receive the ID of the new order:
{
"id": "E3LUE",
"orderNumber": 513995782,
"vendorOrderNumber": "E3LUE"
}
where:
id
– Order ID visible to the store owner and customers in Ecwid admin and notifications.orderNumber
andvendorOrderNumber
– Deprecated fields for old applications. Useid
field instead.
Last updated
Was this helpful?