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.
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 inwaiting_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.
status value.
Topping up your wallet
To add funds to your wallet:- Call
GET /payments/providersto see available top-up providers. - Call
POST /payments/payment-intentswith the amount and your chosenprovider_id. - Redirect the user to
redirect_urlin the response. - After payment, ProxyJam receives the webhook and credits your wallet automatically.
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.