Agent Checkouts

const res = await fetch(`${BASE_URL}/buyer-profiles`, {
    method: "POST",
    headers,
    body: JSON.stringify({
        label: "Home",
        name: { first: "Ada", last: "Lovelace" },
        contact: { email: "ada@example.com" },
        shipping: {
            addressLines: ["1 Market St"],
            locality: "San Francisco",
            administrativeAreaCode: "US-CA", // ISO 3166-2, country-prefixed
            postalCode: "94105",
            countryCode: "US", // ISO 3166-1 alpha-2, required
        },
    }),
});

const { id: buyerProfileId } = await res.json(); // 201 — save this

const res = await fetch(BASE_URL, {
    method: "POST",
    headers,
    body: JSON.stringify({
        target: {
            kind: "direct_url",
            url: "https://merchant.example/products/classic-tee",
            request: "buy the medium in black", // optional
        },
        buyerProfileId, // attach the saved buyer profile
        constraints: {
            maxCost: { amount: "100.00", currency: "USD" }, // required
        },
    }),
});

const { id } = await res.json();

const TERMINAL = ["succeeded", "failed", "cancelled"];

async function getCheckout(id: string) {
    const res = await fetch(`${BASE_URL}/${id}`, { headers, cache: "no-store" });
    return res.json();
}

let checkout = await getCheckout(id);
while (!TERMINAL.includes(checkout.status)) {
    // Show the user the live session (next step)…
    if (checkout.status === "awaiting_user_action") {
        await respond(checkout); // …and answer when asked (step after)
    }
    await new Promise((r) => setTimeout(r, 1500));
    checkout = await getCheckout(id);
}

// embedUrl may be relative to the Crossmint origin — resolve it against the
// API host, or an <iframe src> resolves it against your origin and 404s.
const embedUrl = new URL(checkout.browser.embedUrl, "https://www.crossmint.com").toString();

<iframe src={embedUrl} allow="clipboard-write" />;

async function respond(checkout) {
    const action = checkout.pendingUserAction;
    // action.responseSchema → walk .properties to render inputs
    // action.expiresAt      → respond before this or the checkout fails

    await fetch(`${BASE_URL}/${checkout.id}/actions/${action.id}`, {
        method: "POST",
        headers,
        body: JSON.stringify({
            action: "submit",
            values: { fullName: "Ada Lovelace", country: "GB" /* … */ },
        }),
    });
}

if (checkout.status === "succeeded") {
    const { total, merchantOrderId, evidence } = checkout.receipt;
}

if (checkout.status === "failed") {
    const { reason, message } = checkout.failure;
    // reason: max_cost_exceeded | user_cancelled | user_action_expired
    //         | automation_failed | automation_timeout | llm_spend_exceeded
}