Account and go-live overview. Start here: returns whether the account can take live payments, go-live progress, business verification state, the pricing audit state, whether a payout account is connected, and the single next step to take. Changes nothing.

Ask for the free Revenue & Pricing Audit. Use when the merchant wants the free Revenue & Pricing Audit of a page where they sell; url is required. Starts a written review of their pricing and checkout; it costs nothing and does not block going live. Check progress with agenta_audit_show.

The audit state, and download the report PDF once it exists. Returns whether an audit was requested, its state, its grade and the report PDF link once it is written. Changes nothing. If none was requested, use agenta_audit_request.

Submit business verification so the merchant can accept live payments. Sends the business or individual details for review so the account can take live payments. Required: legalName, country, street, city, url, acceptDeclaration true, and registrationNumber when entity is business. Only set acceptDeclaration after the merchant has read agenta_verify_declaration. Returns the new verification state.

Where the verification has got to. Returns the business verification state (not started, in review, changes requested, on hold, rejected or verified), with any changes requested and the reason for a hold or rejection. Changes nothing. For the whole go-live picture use agenta_status_get.

Send back for review after making the changes we asked for. Use only when verification is in the changes-requested state and the merchant has made the changes; sends it back for review. Returns the new state.

The five statements --accept-declaration attests to. Read-only. Returns the five statements a merchant attests to when submitting business verification, the product categories AgentaOS does not support, and what happens if a statement is false. Show these to the merchant before calling agenta_verify_submit with acceptDeclaration true.

Create a product (one-time) or a subscription plan. Creates something buyers can pay for: a one-time product, or a subscription plan with an interval. Returns the product id and its buyer link, which can be shared as is. Use the id with agenta_pay_checkout or as a plan for agenta_subscriptions_change_plan.

List products and plans. Returns the merchant's products and subscription plans with their ids, prices, currencies and buyer links, up to limit (1 to 100). Changes nothing.

Create a checkout session. Creates a one-off checkout for an amount and returns its checkoutUrl to send to the buyer, its sessionId and when it expires. The buyer pays by card; tax is added by AgentaOS. Follow up with agenta_pay_get.

Get checkout session status. Returns one checkout by sessionId: open, completed (paid), expired or cancelled, with amount, currency and link. Changes nothing.

List checkout sessions. Returns checkouts with their status, amount and sessionId, optionally only one status (open, completed, expired, cancelled), up to limit (1 to 100). Changes nothing.

Move a subscription to another plan (upgrade charges now, downgrade at period end). Moves one subscription to another plan with the same currency and interval: an upgrade is charged now (prorated), a downgrade applies at period end. Set dryRun to get the price quote without changing anything.

List subscriptions. Returns the merchant's subscriptions with their id, plan, status and subscriber; pass code to see only subscribers who used that discount code. Changes nothing. Use an id with agenta_subscriptions_cancel, agenta_subscriptions_change_plan or agenta_subscriptions_credit.

Cancel a subscription (at period end by default). Cancels one subscription. By default it stays active until the end of the paid period; set immediately to end it now. Ask the merchant before calling this.

Put credit on a subscriber’s account, taken off their next invoice. Adds credit to one subscription, in the plan's currency; it is taken off the subscriber's next invoices. The reason is stored for the merchant only. Returns the credit given.

Credits given on a subscription, and what is still unspent. Returns the credits given on one subscription and how much is still unspent. Changes nothing.

Create a discount code buyers type at checkout. Creates a code buyers type at checkout to get money off, or a tracking-only code that records who a referral brought in. Returns the code and its id.

List discount codes. Returns the merchant's discount codes with their id, whether each is a discount or tracking only, the plan it applies to and whether it is active, up to limit (1 to 100). Changes nothing.

Show one discount code: what it takes off and how many people used it. Returns one discount code by id: what it takes off, its limits, and how many buyers used it. Changes nothing.

Stop a discount code working. Stops one discount code working for new purchases; subscribers who already used it keep their discount. Ask the merchant before calling this.

List customers. Returns the people who bought from the merchant, with their email, name, country and customer id, up to limit (1 to 100). Changes nothing.

List invoices. Returns the merchant's invoices with their id, amount, currency, status and buyer, up to limit (1 to 100). Changes nothing. Use an id with agenta_invoices_receipt or agenta_invoices_send_receipt.

Download the receipt PDF for a paid invoice. Returns the receipt PDF for one paid invoice; a tool call gets the link, the CLI saves the file. Changes nothing.

Re-send the receipt email to the buyer on file. Emails the receipt for one paid invoice again to the buyer's address on file. Sends an email to the buyer.

List the businesses you manage. Returns the businesses this account manages (its clients or its other apps), with id, name and status. Changes nothing. Pass a business id as business on any other tool to act for it.

Show one business you manage. Returns one managed business by id: its name, status, whether its identity is verified and any open invitation. Changes nothing.

Add a business you manage — a client's business, or another app of your company. Adds a business this account manages, for a client or another app. Optionally invites the client as its admin by email. Returns the business id; pass it as business on other tools to act for it.

Send your client's invitation again (a new link; the old one stops working). Sends a new invitation link to the client admin of one managed business; the previous link stops working. Sends an email unless email is false.

Withdraw your client's open invitation. Withdraws the open invitation of one managed business so its link stops working. Ask the merchant before calling this.

Get the identity check link for your client (only they can complete it). Returns the identity check link for one managed business. Only the client can complete it, so send them the link. Changes nothing if they are already verified.