Payments

Top up the balance

Creates a crypto invoice. Send crypto_amount to pay_address before expires_at; the balance is credited once the network confirms it.

POST/payments

Authorization

Authorizationheaderrequired

Bearer rv_…, a key with the topup scope. About keys

application/json

amount_usdnumberrequired

USD, at least 1.

crypto_currencystringoptional, default "usdtbsc"

Coin and network, see the list below.

crypto_currency values

usdtbsc USDT on BEP20

usdtsol USDT on Solana

usdttrc20 USDT on TRC20, +$4 network fee

usdterc20 USDT on ERC20, +$2

usdcbsc USDC on BEP20

usdcsol USDC on Solana

usdc USDC on ERC20, +$2

btc Bitcoin

eth Ether

ltc Litecoin

sol Solana

bnbbsc BNB

xmr Monero

idstring (uuid)

order_refstring

Reference shown on the receipt.

amount_usdstring (decimal)

crypto_currencystring

crypto_amountstring (decimal)

Exactly this much.

pay_addressstring

Send it here.

statusstring

waiting, confirming, confirmed, expired, …

expires_atstring (datetime)

200Success.

401No key, a wrong key, or a revoked or expired one.

429More than 120 requests a minute with one key, or too many wrong keys from one address.