Themes built on the Twig templating engine are now deprecated and require migration to Vitrin to ensure continued support and compatibility with Zid.

Duplicate Cart

Developing

POST

https://api.zid.sa//cart/clone

Creates a new cart by duplicating the current reserved cart.

This endpoint only works when the cart is reserved (i.e., payment has already been initiated).

It’s typically used to:

Retry a failed payment

Restart checkout without losing cart contents

Create a fresh cart after reservation

Preconditions

The current cart must be reserved (is_reserved = true)

Payment initiation must have occurred

If these conditions are not met, the operation may fail.

Request

None

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢201Success

application/json

Body

Example

{
    "id": "cart_new_123",
    "session_id": "sess_new_abc",
    "phase": "cart",
    "is_reserved": false,
    "products_count": 2,
    "total_value": 250,
    "basket_url": "https://store.example.com/cart",
    "...": "All other cart fields identical to GET /cart"
}

Modified at 2025-12-29 06:41:02

Remove Cart

Add Cart Item

Duplicate Cart

Preconditions#

Request

Request Code Samples

Responses

Preconditions