---
title: "Top up the balance · API | Rdp.Vision"
description: "POST /payments: Creates a crypto invoice. Send crypto_amount to pay_address before expires_at; the balance is credited once the network confirms it."
url: https://rdp.vision/docs/api/payments/create
---

Open in AI

[ChatGPT](https://chatgpt.com/?q=Read%20https%3A%2F%2Frdp.vision%2Fdocs%2Fapi%2Fpayments%2Fcreate.md%20and%20help%20me%20use%20the%20Rdp.Vision%20API.)[Claude](https://claude.ai/new?q=Read%20https%3A%2F%2Frdp.vision%2Fdocs%2Fapi%2Fpayments%2Fcreate.md%20and%20help%20me%20use%20the%20Rdp.Vision%20API.)

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

`Authorization`header required

`Bearer rv_…`, a key with the `topup` scope. [About keys](https://rdp.vision/docs/api/authentication)

## Body

application/json

`amount_usd`number required

USD, at least 1.

`crypto_currency`string optional, 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

## Response

`id`string (uuid)

`order_ref`string

Reference shown on the receipt.

`amount_usd`string (decimal)

`crypto_currency`string

`crypto_amount`string (decimal)

Exactly this much.

`pay_address`string

Send it here.

`status`string

waiting, confirming, confirmed, expired, …

`expires_at`string (datetime)

## Status codes

- 200 | Success.
- 401 | No key, a wrong key, or a revoked or expired one.
- 429 | More than 120 requests a minute with one key, or too many wrong keys from one address.

Request

curl -X POST "https://rdp.vision/api/v1/payments" \\
  -H "Authorization: Bearer $RDPVISION\_KEY" \\
  -H "Content-Type: application/json" \\
  -d '{"amount\_usd":50,"crypto\_currency":"usdtbsc"}'

Response

{
  "id": "b81e0c47-6a2f-4d39-9e15-d2c84f7a03b9",
  "order\_ref": "P7XK2M9Q",
  "amount\_usd": "50.00",
  "crypto\_currency": "USDTBSC",
  "crypto\_amount": "50.00",
  "pay\_address": "0x4f2a…9c1e",
  "status": "waiting",
  "expires\_at": "2026-11-12T19:20:00Z"
}