What merchants are supported?
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.Can I place real orders?
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.Whose card pays, and who charges the shopper?
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.
How much does it cost?
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.
What happens if checkout fails?
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_mismatchortotal_mismatch— the hash or total is stale. Read the checkout again.commit_unknown— the order may have been placed. Do not retry. Callget_orderto check the outcome.
Do I need to handle sign-in?
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.What is review_hash?
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.Can I test without placing real orders?
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.How do I collect card details?
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.Where do I find my API key?
Where do I find my API key?
The API Keys page in the console, or your welcome email.
The same page shows today’s search usage against your daily cap.
What's the difference between MCP and REST?
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.