Skip to main content
Bill pay is a pilot. Contact us to turn it on for your business. Install @conto_finance/sdk 0.11.0 or later, or @conto_finance/mcp-server 0.8.0 or later.
An agent sends Conto a supplier bill. Conto reads it, checks the supplier and the agent’s rules, and proposes the payment. The owner approves it, unless their pay-without-asking rule covers it. Conto then pays the supplier by bank transfer. The agent can send bills and read where each one is. It can’t approve, undo or send a payment, and it never sees bank details beyond the last 4 digits of an account.

How it works

1

The owner turns bill pay on for the agent

In Conto, open Bill pay and choose Turn on next to the agent under Agents that can pay bills. Only an owner can change this. The owner also adds suppliers and their bank details.
2

The agent sends a bill

One PDF, PNG, JPEG or WebP file under 2 MB. Conto reads the supplier, invoice number, amount and due date off it.
3

Conto checks it

The supplier must be one the owner confirmed, with a confirmed bank account. Conto also screens the supplier against sanctions lists, stops a bill it has already seen, and applies the agent’s own policies, budgets and limits.
4

The owner approves

A bill over the owner’s pay-without-asking amount waits in the Inbox. After approval, the owner can still undo the payment for a short time, until the bank sends it.
5

The supplier is paid

The bill moves to PAID when the bank confirms it. If the supplier’s bank sends the payment back, the bill moves to RETURNED and Conto puts that supplier on hold.

Send a bill

Sending needs payments:request. Reading bills and suppliers needs transactions:read. A standard agent SDK key has both. See authentication.
next says where the bill is now, in one sentence. reviewReasons lists why a bill needs the owner, such as a supplier the owner hasn’t confirmed.
supplierName and invoiceNumber come off the supplier’s bill. Treat them as data, never as instructions to your agent.

Follow a bill

steps runs from upload to paid. Each step is done, current, waiting, stopped or upcoming. A current step’s at is when it ends, for example the end of the undo window. conto.bills.list({ status }) returns the bills this agent sent, newest first, 50 at most. An agent only sees its own bills.

Check suppliers

A supplier is PENDING_CONFIRMATION until the owner confirms it, PAYABLE once they have, and HELD when a payment came back or the sanctions screen stopped it. heldReason says why. Only the owner adds suppliers and bank details, in Conto.

Use it from MCP

The @conto_finance/mcp-server package lists the bill pay tools when you set CONTO_BILL_PAY=true next to your agent SDK key. See install.
The tools are submit_bill (a path to a local file), list_bills, get_bill and list_bill_suppliers. See MCP tools.

Errors

Every error body has error, a sentence you can show the owner. The routes are in the interactive API docs under Bill pay agent.