Skip to main content
An agent that buys with Sapiom has three parts. Each holds a key and does one job. A purchase moves through them in order:
  1. Your agent creates the purchase, with the MCP tools or the REST API.
  2. Sapiom checks the budget and your spending limits. Inside the budget, nothing is asked.
  3. At payment_ready, your payment code takes over the agent’s browser and pays.
  4. Sapiom Browser Pay swaps in the real card on its way to the merchant.
  5. Your agent confirms the order and tells the user.

Keep the placeholder card out of the model

The placeholder card works only for this purchase, but it’s still card data. Don’t put it in your agent’s prompt or logs. At payment_ready, the MCP transaction tools return payment.placeholder to whoever called them, so give your agent a tool that runs your payment code, and let that code read the placeholder itself.
See Make a purchase for the payment code.