> ## Documentation Index
> Fetch the complete documentation index at: https://docs-stage.bglobale.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Checkout Cart Information (from Global‑e)

> Global-e retrieves the shopper's cart contents from the merchant for international checkout via the GetCheckoutCartInfo API.

The `GetCheckoutCartInfo` API retrieves cart information for international checkout processing. This API:

* Is triggered when the cart page loads or when a checkout attempt is made
* Only returns products that are in stock
* Requires proper cart token validation
* Is part of Global-e's extensions (custom integration only)

This method is called from a Global-e server with the cart token rendered in a cookie or HTML.DOM. The client's session calculates the price totals. The `GetCheckoutCartInfo` API returns all cart contents, including customer information for logged-in customers.

This API only returns products that are in stock. If special handling is required for stock validation on your side, for products in the basket (for example, calls to an external system), Global-e can specify an additional URL for this method, to indicate that stock validation is specifically required.

If the cart data is unavailable, the checkout will not open and an error message will appear in the browser development console.

The `GetCheckoutCartInfo` API is only triggered upon the cart page loading, or when a checkout attempt is made.

<Info>
  This API is part of Global-e's extensions and plug-ins. Merchants do not need to implement this API unless a custom integration is required.
</Info>

## Usage

* Displays totals on the basket page
* Opens the checkout process
* Validates order ([SendOrderToMerchant](/api-reference/send-order-to-merchant))

## Security Requirements

* **Client-side**: Session and Cart token (present in the request URL parameters)
* **Server-side**: For both GET and POST:
  * Cart token — Request URL parameter (required)
  * Custom parameter — Request URL parameter (optional)
  * Custom header (optional)
  * IP whitelist (optional)
  * HTTP Basic Authentication (optional)
  * JWT (optional)
* Additional methods available with POST only:
  * OrderID — In the request payload
  * Merchant GUID — In request payload (required)

## Retry Logic

None. The `GetCheckoutCartInfo` API is only triggered upon the cart page loading, or when a checkout attempt is made. If the `GetCheckoutCartInfo` request fails to execute on the cart page, the international cart totals will not be calculated or displayed there. If the `GetCheckoutCartInfo` request fails on the checkout, the checkout will not open.

## Method/URL

* Client-side: `GET`
* Server-side: `GET` / `POST` (default `GET`). Global-e can configure your preference.

```
GET https://www.merchant-site-domain.com/get-checkout-cart-info-url
POST https://www.merchant-site-domain.com/get-checkout-cart-info-url
```

<Warning>
  Some values in the payload are encoded and must be decoded by the merchant — for example URLs, addresses, emails, and phone numbers.
</Warning>

## Reference

<div className="api-ref-card">
  <Card title="Get Checkout Cart Info — full request & response" icon="code" href="/api-reference/get-checkout-cart-info">
    Parameters, schema, and examples for `GET /get-checkout-cart-info-url` (merchant-hosted).
  </Card>
</div>