CLI · Billing
buyproxy topup
Buy bandwidth by card or crypto — the CLI opens checkout and waits for your payment.
Usage
$ buyproxy topup [product] [--gb 25] [--card|--crypto] [--pool] [-y] [--no-open] [--no-wait]Aliases: buyproxy buy
topup buys pay-as-you-go bandwidth for one product. You see the live price and any volume bonus before anything is charged, pay on a secure hosted page, and the CLI waits for the payment to settle so you know the moment your GB is live.
Options
| Option | What it does |
|---|---|
| [product] | Product key: residential, premium, isp, mobile, ipv4 or ipv6. |
| -g, --gb <n> | How many GB (a whole number from the product's minimum to 10,000). |
| --card | Pay by card (Stripe Checkout). |
| --crypto | Pay with cryptocurrency (BTC, ETH, USDT and more). |
| --pool | Reseller keys: buy into your reseller pool instead of your own plan. |
| -y, --yes | Skip the "Continue to payment?" confirmation. |
| --no-open | Don't open the browser — just print the payment link. |
| --no-wait | Print the link and return immediately instead of waiting for payment. |
Plus the global options (--json, --key, --no-color, --help).
How it works
- Prices load live from BuyProxy, so what you see is what you're charged.
- Pick a product and an amount (guided prompts, or
[product]and--gb). Each product has a minimum — 1 GB for most, 2 GB for Premium. - Choose card or crypto. Card payments go through Stripe Checkout; crypto uses an invoice page.
- Review the order. Orders of 100 GB or more get a 10% bonus, shown before you confirm.
- Pay. The CLI creates the checkout, prints the link and opens your browser.
- Wait. In a terminal the CLI polls every few seconds (up to 15 minutes) and shows a receipt when the payment succeeds. Card payments settle in seconds; crypto waits for network confirmations.
If you press Ctrl-C while waiting nothing is lost — pick it up later with buyproxy tx <id> --wait.
Examples
Guided
$ buyproxy topup? Which product? Core Residential
? How many GB? (min 1) 100
? Pay with Card
╭─ Order ─────────────────────────╮
│ Product Core Residential │
│ Bandwidth 100 GB + 10 GB bonus │
│ Total $99.00 via card │
╰─────────────────────────────────╯
? Continue to payment? Yes
✔ Checkout ready
Pay here: https://checkout.stripe.com/c/pay/cs_live_…
⠋ Waiting for your payment — finish checkout in the browser (Ctrl-C to stop waiting)One line
$ buyproxy topup residential --gb 100 --card -yCrypto, just give me the link
$ buyproxy topup premium -g 20 --crypto --no-open --no-waitReseller pool
$ buyproxy topup residential -g 500 --card --poolNeeds a bp_live_… key. The GB lands in your pool, ready to allocate to customers.
Machine-readable
$ buyproxy topup residential -g 10 --card -y --json{"url":"https://checkout.stripe.com/c/pay/…","transactionId":"st_5b1c…"}JSON output
With --json the command prints { "url": …, "transactionId": … } and returns without waiting — poll with buyproxy tx <transactionId> --json.
Troubleshooting
| You see | How to fix it |
|---|---|
| Say which product to top up. / Say how many GB with --gb. / Choose a payment method: --card or --crypto. | Without a terminal there are no prompts, so pass all three. |
| Card payment isn't available right now — please use crypto. | Card checkout is temporarily unavailable; retry with --crypto. |
| --gb must be a whole number from 6 to 10 000 for Core Residential. | Each product has its own minimum; the maximum per order is 10,000 GB. |
| Still pending. Check later with: buyproxy tx <id> --wait | The payment hadn't settled in 15 minutes — usually crypto waiting on confirmations. |
Tips
Prefer a subscription? See
buyproxy subscribe— plans include GB every month at a lower per-GB rate.Crypto payments are final; card payments follow the refund policy at buyproxy.org/legal/refunds.
Related commands
Was this page helpful?