Skip to content

docs(cart): define the continue_url destination and format #801

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
YanisMtcr wants to merge 1 commit into
base: main
Choose a base branch
from
+33 −2
Open

docs(cart): define the continue_url destination and format #801

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
35 changes: 33 additions & 2 deletions docs/specification/shopping/cart/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -89,6 +89,37 @@ SHOULD be linked for the duration of the checkout.
on a cleared cart ID return `not_found`; the platform can start a new
session with `create_cart`.

## Continue URL

The `continue_url` field hands a cart from the platform to the business UI, so
a buyer can share, recover, or keep building the cart in a browser, or move on
to purchase.

### Destination

The destination is the business's choice: its cart page, its checkout entry,
an embedded flow, or any surface that fits its purchase path. Whatever the
destination, it **MUST** present the cart's current `line_items`, with their
quantities and selected variants, without requiring the buyer to add them
again. Items that can no longer be offered at resolution time follow the
[permalink redirect resolution rules](../../permalink.md#redirect-resolution).

A cart session is served by the business's UCP endpoint, and that endpoint does
not always share state with the storefront. A `continue_url` that points at the
storefront's own cart page then lands the buyer on an empty basket.

### Format

The `continue_url` **MUST** be an absolute HTTPS URL and **MUST** carry or
reference the cart contents. Businesses **MAY** use either approach described
in the [checkout Continue URL format](../checkout/index.md#format):

* an opaque URL backed by server-side cart state, for example
`https://business.example.com/carts/{cart_id}`;
* a stateless URL that encodes the cart's items, such as a
[permalink](../../permalink.md), which the business resolves into a cart
or a checkout.

## Quantity and sale basis

Cart line items apply the shared
Expand Down Expand Up @@ -147,8 +178,8 @@ custom scopes are defined in [Identity Linking — Scopes](../../common/identity

### Business

* **SHOULD** provide `continue_url` for cart handoff and session recovery.
* TODO: discuss `continue_url` destination - cart vs checkout.
* **SHOULD** provide `continue_url` for cart handoff and session recovery. See
[Continue URL](#continue-url) for destination and format.
* **SHOULD** provide estimated totals when calculable.
* **MAY** omit fulfillment totals until checkout when address is unknown.
* **SHOULD** return informational messages for validation warnings.
Expand Down
Loading