Skip to main content
In a few minutes you will set up one buyer end to end: create the buyer, save a card for them, and connect an agent that acts as them. No transaction is made. You need:
  • A platform key that can create buyers (org.tenants.write). Request access to get one. Save it as SAPIOM_PLATFORM_KEY.
  • An agent client that can connect to remote MCP servers. The examples use Claude Code.
1

Create a buyer

A buyer represents one of your users. Use your own ID for that user as externalId:
Save the id from the response as BUYER_ID.
2

Create a key for the buyer

Save plainKey from the response as SAPIOM_BUYER_KEY. It is shown only once.
3

Save a card for the buyer

Create a setup link with the buyer’s key:
Open the url from the response and save a card. In production, you send this link to your user instead.
4

Connect your agent as the buyer

Ask your agent: “List my Sapiom payment methods.” It shows the card you just saved, with its brand and last four digits.
5

Check a merchant

Ask your agent: “Can Sapiom buy from shop.example?”, with a real store’s domain. The answer is supported, unsupported or unknown. supported means the store offers UCP checkout.
You now have a buyer with a saved card and an agent that acts for that buyer. In production, your agent switches keys for each user it serves. See Connect your agent.

​
Next steps

Authorize a transaction

Send a merchant checkout and get the buyer’s approval.

Manage buyers

Set up buyers for real users in production.