Proxy-seller

Bilancio e pagamenti

Updated:

Autorizzazioni: account:read, account:write, fatturazione:scrivi

In questo gruppo

Strumento

Cosa fa

get_balance

🢢 read

Saldo attuale in USD.

list_payments

🢢 read

Metodi di pagamento esterni (PayPal, carta, criptovalute…) con i relativi ID.

add_balance

💳 pays

Effettuare una ricarica di saldo e fornire un link per il pagamento.

get_autotopup

🢢 read

Impostazioni di ricarica automatica: abilitata, soglia, importo, carta vincolata, ultimo tentativo.

set_autotopup

💳 pays

Attivare o modificare la ricarica automatica: quando il saldo scende a threshold, amount viene addebitato sulla carta vincolata.

disable_autotopup

🟡 write

Disattiva la ricarica automatica.

get_balance

🢢 read-only · account:read

Saldo attuale in USD.

list_payments

🟢 read-only · account:read

Metodi di pagamento esterni (PayPal, carta, criptovalute…) con i relativi ID. Il saldo dell’account non viene indicato — è sempre disponibile come paymentId: "balance".

add_balance

💳 spends money · billing:write

Ricarica il saldo con un metodo di pagamento esterno. Se è già presente una carta collegata all’account, l’addebito avviene immediatamente; con qualsiasi altro metodo viene generato un link di pagamento da completare nel browser.

Parametro

Tipo

Descrizione

summ obbligatorio

numero

Quantità: minimo 1

paymentId obbligatorio

stringa | numero intero

ID metodo da list_payments

get_autotopup

🢢 read-only · account:read

Impostazioni di ricarica automatica: abilitata, soglia, importo, carta vincolata, ultimo tentativo.

set_autotopup

💳 spends money · billing:write

Attivare o modificare la ricarica automatica: quando il saldo scende a threshold, amount viene addebitato sulla carta associata. La carta deve essere prima associata nella dashboard del venditore proxy.

Parametro

Tipo

Descrizione

threshold

numero

USD

amount

numero

USD

subscriptionId

string

Abbonamento con carta vincolata; mantenere quello esistente come impostazione predefinita

disable_autotopup

🟡 changes account state · account:write

Disattiva la ricarica automatica. Le impostazioni vengono conservate per poterle riattivare in seguito. Nessun parametro.

Prossimi passi

On this page