Skip to main content
New to payments? These are the terms that show up across the docs, in one place.
The legal seller of your product. Your buyer pays AgentaOS, not you, so AgentaOS collects the money, charges and remits the tax, issues the invoice, and pays you out. AgentaOS carries the tax liability as the legal seller. A lost dispute costs you the sale plus the dispute fee: see Refunds and disputes.
VAT charged at the rate of the buyer’s country, not yours. While AgentaOS sells under the EU distance-selling threshold, the checkout charges EU consumers the Estonian rate instead. See How tax works.
The EU scheme that lets one registration cover VAT across all EU countries. AgentaOS does not use OSS: it sells under the EU distance-selling threshold from its registration in Estonia. Either way, you never register in each country you sell to.
For a B2B sale to a VAT-registered business in another EU country, VAT shifts to the buyer, so the invoice shows no VAT. A buyer who enters a valid EU VAT ID at checkout is handled this way.
The thing you sell, with its price. The API calls a product a payment link; there is no separate product API. The product’s API ID is the linkId.
The payment link UUID (paymentLinks.id). Pass it to checkouts.create({ linkId }). On the product page, open Building this into your site? and click Copy ID. It is not the /pay/… URL and not the checkout sessionId.
A single attempt to collect one payment. Created on its own or from a product with checkouts.create({ linkId }). Every checkout has a checkoutUrl you send the buyer to (/checkout/{sessionId}).
A recurring charge on a card on file, billed automatically every cycle until canceled.
An invoice is the tax document for a sale (seller, buyer, VAT breakdown), issued automatically on every payment. A receipt is the emailed confirmation the buyer gets that they paid.
The behind-the-scenes step where a completed payment becomes money in your balance, after the card or bank network clears it.
Available now is cleared money that the next payout sends. On the way is sales that are still clearing, for 14 days after each sale, with the date each amount becomes available. Reserve is a safety hold on new accounts to cover refunds and chargebacks; the row shows the date it frees up. See Payouts.
A portion of your balance held temporarily on newer accounts to cover potential refunds or chargebacks. It releases automatically.
Money moving from your Available now balance to your bank account. Payouts go out in two windows each month, the 1st and the 15th. A new account starts on You ask: click Request payout and the next window pays it. Choose Automatic to be paid every window. See Payouts.
When a buyer’s bank reverses a card payment. While the dispute is open, the sale’s money shows in Paused (disputed) on your balance and is not paid out. See Refunds and disputes.
Test mode uses fake money and test cards, safe to explore, no verification needed. Live mode takes real money and unlocks after business verification.
A signed HTTP call AgentaOS makes to your server when something happens (like a completed checkout), so your app does not have to keep asking.