Check a Price Without Buying

A product page often does not show the final price. Shipping, tax, and discounts appear only at the checkout. To get the exact total, run a checkout to the payment step, read the amount, and cancel the checkout. Nothing is bought.

Prerequisites

Agent Checkouts integration — complete the quickstart.
Server key — a production key with agent-checkouts.create, agent-checkouts.read, agent-checkouts.update, and agent-checkouts.cancel.

Get the Total

Start the checkout

Give the product and its options in the task. Set maxCost above the price that you expect, so that the checkout can reach the payment step. A buyer profile gives the shipping address that the total depends on.

const BASE_URL = "https://www.crossmint.com/api/unstable/agent-checkouts";
const headers = {
    "Content-Type": "application/json",
    "X-API-KEY": process.env.CROSSMINT_SERVER_API_KEY!,
    "x-crossmint-user-id": "YOUR_USER_ID",
};

const response = await fetch(BASE_URL, {
    method: "POST",
    headers,
    body: JSON.stringify({
        request: {
            startUrl: "https://shop.example.com/products/wireless-headphones",
            task: "Go to the checkout for one pair of the wireless headphones in black, with standard shipping.",
        },
        buyerProfileId: "YOUR_BUYER_PROFILE_ID",
        constraints: { maxCost: { amount: "500.00", currency: "USD" } },
    }),
});
if (!response.ok) {
    throw new Error(`Could not start checkout: ${response.status}`);
}
const { runId } = await response.json();

Read the total from the payment request

Follow the checkout and answer its questions. When it reaches the payment step, the status is awaiting_input and the question is a payment request. When interaction.amount.kind is "exact", interaction.amount.value is the total:

{
    "kind": "payment",
    "purpose": "checkout_payment",
    "method": "card",
    "amount": { "kind": "exact", "value": "348.00", "currency": "USD" },
    "merchant": { "name": "Example Shop", "url": "https://shop.example.com", "countryCode": "US" }
}

When amount.kind is "maximum", amount.value is your spending cap, not the total: the merchant did not show a final total before the payment. Do not show it as the price.

Cancel the checkout

Do not answer the payment request. Cancel the checkout:

// Uses BASE_URL, headers, and runId from the first step.
const cancelResponse = await fetch(`${BASE_URL}/${runId}/cancel`, { method: "POST", headers });
if (!cancelResponse.ok) {
    throw new Error(`Could not cancel checkout: ${cancelResponse.status}`);
}

The cancel request returns 202 Accepted. Keep reading the checkout until its status is cancelled.

Show the total

Show the total to the user. To buy later, start a new checkout and pay with an order intent. See Pay for a Checkout.

Common Gotchas

The total changes before the purchase

Prices, shipping, and stock can change. The total of a later purchase can be different. Set maxCost on the purchase to the highest total that the user accepts.

Each check costs a checkout

Crossmint bills each checkout that starts, also when you cancel it.

Next Steps

Buy When the Price Drops

Buy automatically under a limit

Pay for a Checkout

Answer a payment request with an order intent

Create a Checkout

Review the complete create request schema

Introduction

Agent Cards

Agent Wallets and Onramps

Agent Checkouts

API Reference

Check a Price Without Buying

Prerequisites

Get the Total

Common Gotchas

Next Steps

Buy When the Price Drops

Pay for a Checkout

Create a Checkout

​Prerequisites

​Get the Total

​Common Gotchas

​Next Steps

Buy When the Price Drops

Pay for a Checkout

Create a Checkout

Prerequisites

Get the Total

Common Gotchas

Next Steps