Proxy-seller

Balance and payments

Updated:

Permissions: account:read, account:write, billing:write

In this group

Tool

What it does

get_balance

🟢 read

Current balance in USD.

list_payments

🟢 read

External payment methods (PayPal, card, crypto…) with their ids.

add_balance

💳 pays

Create a balance top-up and return a payment link.

get_autotopup

🟢 read

Automatic top-up settings: enabled, threshold, amount, bound card, last attempt.

set_autotopup

💳 pays

Turn on or change automatic top-up: when the balance drops to threshold, amount is charged to the bound card.

disable_autotopup

🟡 write

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

summ required

number

Amount, minimum 1

paymentId required

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

threshold

number

USD

amount

number

USD

subscriptionId

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.

Next steps

On this page