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:

  • idOrder ID visible to the store owner and customers in Ecwid admin and notifications.

  • orderNumber and vendorOrderNumber – Deprecated fields for old applications. Use id field instead.

Last updated

Was this helpful?