Add the checkpoints
You need an agent and its SDK key. Create the agent in the dashboard, then choose Generate SDK Key on its SDK Integration tab.checkoutMethod defaults to LINK, so a Link checkout can leave it out. checkoutUrl is the
store’s checkout page. Conto names the merchant by its domain. See
the merchant is the checkout domain.
Reuse the same idempotencyKey when you retry begin(). After a timeout, read the checkpoint with
conto.checkout.get() before you retry. Never submit the payment twice.
Checkout checkpoints covers every stage, the HTTP endpoints, and
the MCP tools.
When the owner must approve
New organizations start with these limits: 100 a day, and owner approval above 15 purchase above goes to the owner for approval. See starter guardrails. When a rule requires approval,begin() returns the stage AWAITING_APPROVAL. Conto holds the $15
against the agent’s limits and sends the owner an approval request. Do not open Link while the
checkpoint waits.
waitForApproval() returns the checkpoint once the owner approves it. The agent then has 30
minutes to confirm. If the owner rejects the purchase or the request expires, waitForApproval()
throws and Conto releases the spend. See
when the owner must approve.
Report the outcome
After the agent submits the payment, it reports one outcome on the confirmed checkpoint:PAIDkeeps the amount counted toward the agent’s limits.NOT_PAIDreleases it.UNKNOWNkeeps it counted until the agent reports again or the owner records what happened.
confirm() succeeds. To stop before that, cancel the checkpoint with
conto.checkout.cancel().
What the owner sees
- Approvals. A purchase that needs approval appears in Alerts & Approvals with the merchant, the checkout site, the payment method, the items, the purpose, and the agent. The owner chooses Approve purchase or Reject purchase.
- Transactions. Each checkout appears in Transactions. Its page shows the status, the amount, the agent, the order number, and each step.
- Missing outcomes. When a confirmed checkout has no outcome, the owner gets an alert. After checking the order with the merchant, an Owner, Admin, or Manager chooses Mark as paid or Mark as not paid on the checkout page.