Create cart handoff URL
create_cart_urlBuild the checkout handoff URL once the buyer has confirmed an exact product, quantity, live price, and stock. Preferred input is sku plus quantity; use items only when you already hold variant IDs as strings. Returns a tracked packrift.com cart URL plus a Shopify cart permalink; it never places an order.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sku | No | Shortcut for exact Packrift SKUs such as 1066, MFL1295, or LL251WR. When provided without items, the approved variant is resolved automatically. | |
| items | No | Advanced path for agents that already have approved variant IDs. Most buyers should use sku plus quantity instead. | |
| quantity | No | Buyer-confirmed quantity to use with sku shortcut. Ignored when items is provided. | |
| journey_id | No | Optional continuity ID echoed from an earlier search or pricing result in this conversation. | |
| match_type | No | Optional continuity label describing how the product was matched, echoed from earlier results. | |
| selected_sku | No | Buyer-confirmed SKU. When provided, it must resolve to the same catalog item as the cart variant. | |
| discount_code | No | Optional discount code to apply to the cart. | |
| result_set_id | No | Optional continuity ID echoed from the result set the buyer chose from. | |
| source_context | No | Optional short context label for the handoff, such as exact_match, reorder, or quote_followup. | |
| selected_handle | No | Buyer-confirmed product handle. When provided, it must resolve to the same catalog item as the cart variant. |