CLI · Billing
buyproxy transactions
Payment history — or the status of one payment, optionally waiting for it to settle.
Usage
$ buyproxy transactions [id] [-n 10] [--wait]Aliases: buyproxy tx, buyproxy payments
Every top-up and subscription payment is a transaction. List your recent ones, or look one up by id — and with --wait, block until it settles, which is what scripts want after creating a checkout.
Options
| Option | What it does |
|---|---|
| [id] | A transaction id (from topup or subscribe). Omit to list recent payments. |
| -n, --limit <n> | How many payments to list (up to 100).Default: 10. |
| --wait | With an id: keep polling until the payment is succeeded or failed. |
Plus the global options (--json, --key, --no-color, --help).
How it works
Status is one of pending (waiting for payment), succeeded (paid and credited) or failed (expired or declined — nothing was charged).
A reseller key's pool purchases appear here too, tagged (pool).
Examples
Recent payments
$ buyproxy transactions -n 3Payments
Date Item Method Amount Status ID
────────────────────────────────────────────────────────────────────────────
10/1/2026 100 GB residential card $99.00 succeeded st_5b1c…
9/14/2026 pro plan (yearly) card $324.00 succeeded st_77ad…
9/2/2026 20 GB premium crypto $69.80 pending crypto_e41b…Wait for one payment
$ buyproxy tx st_5b1c… --wait╭─ Payment ──────────────────────╮
│ Item 100 GB residential │
│ Amount $99.00 USD via card │
│ Status succeeded │
│ Date 10/1/2026, 3:42:10 PM │
│ ID st_5b1c… │
╰────────────────────────────────╯JSON output
Returns the transaction (or an array of them): id, kind, status, paymentMethod, interval, amountCents, currency, gb, productKey, plan, resellerPool, createdAt.
Troubleshooting
| You see | How to fix it |
|---|---|
| Transaction not found | Ids are scoped to your account — check you're using the same key that created it. |
Tips
Invoices for succeeded payments are in Dashboard → Billing.
Related commands
Was this page helpful?