1. Create a key
Create an organization API key in Developers > API keys with the Standard preset, which covers buyers, setup links and purchases. Keep the key on your server. To send the buyer back to your app afterward, list your app’s https origin once withadmin.purchasing.settings.update({ allowedReturnOrigins }), then pass returnUrl to createSetupLink(). Updating settings needs org:write, which only the Admin preset includes.
Install @conto_finance/sdk 0.7.0 or later with npm install @conto_finance/sdk.
2. Set up a test buyer
Map one of your users to a buyer and send them to Conto’s setup page.link.url in a browser. It works once and expires in 10 minutes. On the page, confirm the spending limits, add the test card and let the agent shop with it.
The same externalId returns the same buyer, so reuse it while you test. Each buyer uses one agent in your plan.
3. Buy from a test store
buyer_details as above. The buyer opens the review link and approves the items, total and delivery.
4. Read the result
succeeded means the store confirmed the order. paymentEvidence reports authorization, the store’s confirmation and settlement separately.
Go live
Live purchases need Conto to enable them for your organization, a Builder or Enterprise plan, and the buyer’s own card. Until then, live setup links and live purchases are refused withLIVE_NOT_ENABLED. admin.purchasing.capabilities() reports environments.live.available for your organization.
For live, create the setup link without environment: 'test' and buy from a real store URL. For events in production, use webhooks instead of holding a stream open.
Build it with a coding agent
Paste this into your coding agent from your app’s repository:Next
- Personal-agent shopping example: follow a purchase and compare the checkout paths.
- Agentic commerce: choose between Conto-run purchases and a checkout your own agent operates.
- Shopify UCP discovery: how Conto’s shopping chat combines catalog and web results.
- Conto Commerce API reference: statuses, actions, events, webhooks, errors and test stores.
- MCP tools: the purchase tools for agents that call Conto themselves.