Skip to main content
Start a purchase from a product URL and task. Conto runs checkout, the buyer reviews on a secure Conto page, and your platform never handles card details. Test mode needs no enablement from Conto.

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 with admin.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.
Open 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

When the buyer saved delivery details on Conto’s page, Conto answers the delivery form itself. Otherwise answer 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 with LIVE_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