Skip to main content
ProxyJam supports several payment methods for proxy orders. Which ones are live for a given caller can change, so read GET /payments/providers rather than hard-coding the list.

Wallet

Your account wallet holds a USD balance that you top up via a payment provider. When placing an order with "payment_method": "wallet", the order amount is deducted from your balance instantly. No external redirect is required.
Wallet payments are only available for authenticated users. Guest checkout does not support wallet.

CryptoCloud

CryptoCloud allows payment with cryptocurrency. When you place an order with "payment_method": "cryptocloud", the API returns a payment_url you redirect the user to.
After payment is confirmed, CryptoCloud sends a webhook to ProxyJam, which activates the order and provisions the proxies.

Card

"payment_method": "stripe" opens a hosted card checkout and returns a payment_url the same way. Available to authenticated users.

SBP

"payment_method": "rollypay" pays through SBP, the Russian instant bank-transfer rail. The order is priced in USD as everywhere else; the payment page presents the equivalent amount in rubles.
SBP payments settle asynchronously, so one can land after the order expired. It is then credited to the account balance, not to the order, which stays expired — check your balance and transactions.

Unpaid orders and the payment window

An order placed with an external payment method (card, crypto, SBP or Telegram Stars) starts in waiting_payment. While it stays there, GET /orders and GET /orders/{order_id} return its payment_url, so you can send the customer back to the payment page. If the payment window closes before the payment arrives, the order becomes expired and payment_url is null. Nothing was charged, and the order stays expired: to buy, place a new order. What happens to a payment that arrives after the order expired depends on the method:
  • Card and Telegram Stars: the payment page stops accepting payment once the order expires, so there is no late payment.
  • SBP: a payment can settle after the window closed. It is credited to your account balance, which can pay for a new order with "payment_method": "wallet".
  • Crypto: a payment sent after the invoice was cancelled is not credited automatically. Contact support with the payment_intent_id.
See Order statuses for every status value.

Topping up your wallet

To add funds to your wallet:
  1. Call GET /payments/providers to see available top-up providers.
  2. Call POST /payments/payment-intents with the amount and your chosen provider_id.
  3. Redirect the user to redirect_url in the response.
  4. After payment, ProxyJam receives the webhook and credits your wallet automatically.
Each provider advertises a commission_percentage. It is a surcharge on top of the amount you request: ask for a $10.00 top-up from a provider charging 10% and the payer is charged $11.00, while the wallet is credited the full $10.00.
POST /payments/payment-intents requires an Idempotency-Key header. See Idempotency.

Payment flow diagram