> ## Documentation Index
> Fetch the complete documentation index at: https://agentmall.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# FAQ

> Common questions about AgentMall.

> [accordion] What merchants are supported?
>
> Nine: Walmart (`mrc_walmart`), Target (`mrc_target`), Best Buy (`mrc_bestbuy`), Kroger
> (`mrc_kroger`), Instacart (`mrc_instacart`), Albertsons (`mrc_albertsons`), Wegmans
> (`mrc_wegmans`) and FreshDirect (`mrc_freshdirect`) in the US, in USD, and Ocado (`mrc_ocado`) in
> Great Britain, in GBP. Call `list_merchants` for the current list. See
> [Merchants](https://agentmall.mintlify.site/concepts/merchants.md).

> [accordion] Can I place real orders?
>
> Yes. With a live key (`am_live_`), `complete_checkout` submits a real order to the merchant.
> Nothing is placed until your agent approves the exact total.

> [accordion] Whose card pays, and who charges the shopper?
>
> The shopper's own card. The merchant is the merchant of record and charges the shopper directly.
> AgentMall adds no markup to the basket. You give us the card in one of two ways:
>
> * **Our vault (Evervault):** the shopper enters their card once on our hosted page, and you get a token back.
> * **Your vault:** you send us a token from your own vault provider.
>
> Either way, the card number never touches your systems or the model. See [Security](https://agentmall.mintlify.site/concepts/security.md).

> [accordion] How much does it cost?
>
> $0.50 per completed order. Failed orders are free. Search, cart, and checkout operations are free.
>       Orders placed with a test key (`am_test_`) are free: the full flow runs but nothing is submitted
>       to the merchant. New accounts include $5 of credit, 10 free completed orders at \$0.50, from the
> moment you create your organization. Credit may be added to an account case by case, and it pays
> order fees before your card is charged.

> [accordion] What happens if checkout fails?
>
> It depends on the error code:
>
> * `review_changed` — the cart changed since approval. Nothing was placed. Read the new checkout and try again.
> * `review_mismatch` or `total_mismatch` — the hash or total is stale. Read the checkout again.
> * `commit_unknown` — the order may have been placed. **Do not retry.** Call `get_order` to check the outcome.
>
> See [Error Codes](https://agentmall.mintlify.site/reference/errors.md) for every code.

> [accordion] Do I need to handle sign-in?
>
> With `account: "platform"` on `create_cart`, AgentMall uses its own signed-in account at the merchant. No sign-in needed.
>
> With `account: "shopper"`, you sign in with Evervault-encrypted credentials (`ev:` ciphertext). If the merchant sends an SMS challenge, `sign_in` returns `challenge_required` and you call `submit_sign_in_otp` with the code.

> [accordion] What is review\_hash?
>
> A SHA-256 fingerprint of the checkout state: items, quantities, totals, address, delivery method, and payment. `complete_checkout` compares the hash you send with the live checkout. If they differ, it returns `review_changed` with the new state instead of placing the order.
>
> This prevents placing an order on stale data. Always pass the latest `review_hash` from the checkout response.

> [accordion] Can I test without placing real orders?
>
> Yes. Use a test key (`am_test_`). The full checkout flow runs — the review is read and checked —
> but nothing is submitted to the merchant. The order is stored with `test: true` and no fee is
> charged.

> [accordion] How do I collect card details?
>
> Use the console at `console.getagentmall.com/collect?session=ses_…&kind=card`. It opens an
> Evervault iframe that encrypts the card. The result is an `ev:` ciphertext string. Plaintext card
> numbers never touch AgentMall's servers.

> [accordion] Where do I find my API key?
>
> The [API Keys](https://console.getagentmall.com/keys) page in the console, or your welcome email.
> The same page shows today's search usage against your daily cap.

> [accordion] What's the difference between MCP and REST?
>
> Same operations, same error codes, same data shapes. MCP is for AI agents that speak the Model Context Protocol. REST is for backends that want standard HTTP.
>
> Two tools are MCP only: `get_product` and `sign_out`. Everything else is available on both surfaces.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.