Docs
Firmly Agentic Commerce
Docs
Set theme to dark (⇧+D)
  1. Docs
  2. Solutions
  3. Agentic Commerce

Agentic Commerce

​​ Firmly handles the commerce

A single integration with Firmly reaches every connected merchant — no per-destination work for the merchant, no per-merchant work for the destination.

​​ How it fits together

How Firmly fits between AI surfaces and merchants — the destination owns the experience, Firmly owns the commerce, the merchant remains the seller

The destination owns the user-facing experience (chat, voice, wallet UI, app surface). Firmly owns discovery across merchants, cart orchestration, payment, order placement to the merchant’s native platform, and affiliate attribution. Tax and shipping are calculated by the merchant’s platform and returned through the cart — Firmly relays them, it doesn’t compute them.

​​ Use cases at a glance

These are common patterns destinations build on Firmly — recognizable shapes, not an exhaustive list. Every destination type can use any combination of them.

AI Shopping Copilot General-purpose discovery → cart → checkout. Start here if you’re not sure. Deal & Coupon Hunting Find deal-eligible items and apply promo codes at checkout. Smart Payment Selection Pick the best payment per transaction — express wallet, BNPL, saved card, or fresh card. Vertical Specialist Variant-rich multi-product cart for fashion, beauty, supplements. Smart Gifting & Occasion Find a gift, add gift wrap, optionally a gift card, express checkout. Scheduled / Triggered Buying Replenishment, restock, price-drop auto-buy. Destination schedules; Firmly executes. Autonomous Agent Purchasing Mandate-based payment when the cardholder isn’t present — Agentic Pay with network-enforced spending limits.

See Use Cases for the full menu with a comparison table mapping each use case to its closest flow, integration pattern, and recipe.

​​ Three layers of the platform

Discovery Search across connected merchant catalogs and return rich product detail — with live price and stock validation at the merchant.
Cart & Checkout Build the cart, then set shipping address and method. The cart returns merchant-calculated tax and totals. Collect payment via card, PayPal, Klarna, Click to Pay, or Agentic Pay (Network Token Router for autonomous agents).
Order Placement Submit the order to the merchant’s native platform, across industry-standard and custom commerce platforms alike. Firmly’s scope ends here — the merchant’s existing back-office workflows pick up from there.

​​ Start here

Advanced Checkout Guide A complete working Node script from intent to placed order — the fastest way to see end-to-end. Integration Patterns The hub for scoping the build — hosted, embedded, or headless — with links to every API you’ll need. Sandbox Setup Get credentials, pick a test merchant, run your first verified call. Errors & Recovery UCP error catalog with recovery patterns for each.
Consent & Disclosure Where the user’s review and consent sits in an agentic flow — what Firmly expects from the destination, and how to surface it.

​​ What Firmly handles (so the destination doesn’t have to)

  • Affiliate attribution — Firmly relays the originating destination to the merchant so affiliate commissions and attribution flow back without manual reconciliation.
  • Tax and shipping — the merchant’s platform calculates these from its live rules; Firmly relays the results in the cart, and neither Firmly nor the destination computes them.
  • Inventory and price validation — every quote is re-validated against the merchant’s current state before order placement.
  • Payment tokenization and PCI handling — handled at the payment layer.
  • Order placement format — orders land in the merchant’s order management system as if a customer placed them directly, so the destination doesn’t fight per-merchant integration formats.

​​ Which protocol fits your stack

Firmly speaks UCP, MCP, and ACP, plus direct REST. See Protocols for the comparison. The flows and integration patterns on this page apply regardless of which protocol you pick.