Balance and payments
Updated:
Permissions: account:read, account:write, billing:write
In this group
Tool | What it does | |
|---|---|---|
🟢 | Current balance in USD. | |
🟢 | External payment methods (PayPal, card, crypto…) with their ids. | |
💳 | Create a balance top-up and return a payment link. | |
🟢 | Automatic top-up settings: enabled, threshold, amount, bound card, last attempt. | |
💳 | Turn on or change automatic top-up: when the balance drops to | |
🟡 | Turn automatic top-up off. |
get_balance
🟢 read-only · account:read
Current balance in USD.
list_payments
🟢 read-only · account:read
External payment methods (PayPal, card, crypto…) with their ids. The account balance is not listed — it is always available as paymentId: "balance".
add_balance
💳 spends money · billing:write
Top up the balance with an external payment method. A card already linked to the account is charged right away; any other method returns a payment link to complete in the browser.
Parameter | Type | Description |
|---|---|---|
| number | Amount, minimum 1 |
| string | integer | Method id from list_payments |
get_autotopup
🟢 read-only · account:read
Automatic top-up settings: enabled, threshold, amount, bound card, last attempt.
set_autotopup
💳 spends money · billing:write
Turn on or change automatic top-up: when the balance drops to threshold, amount is charged to the bound card. The card must first be bound in the Proxy-Seller dashboard.
Parameter | Type | Description |
|---|---|---|
| number | USD |
| number | USD |
| string | Bound card subscription; keep the existing one by default |
disable_autotopup
🟡 changes account state · account:write
Turn automatic top-up off. Settings are kept for re-enabling. No parameters.