Reseller prepaid balance

Each API key has a prepaid USD balance. The shop admin credits it after you send funds. Then you can pay orders from that balance instead of paying crypto for every order.

Top-ups are done by the shop admin only. The API has no self-top-up — only balance read and order payment.

How it works

You send funds to the shop (crypto / transfer) — as agreed with support.
An admin opens Resellers and clicks “Top up balance” on your key.
GET /api/v1/balance or catalog shows balance_usd.
POST /api/v1/orders or …/pay with pay_currency=balance — usd_value is charged, status paid, tokens go to address.
If balance is too low — 402 Insufficient balance. Then pay the classic way: ton, cryptobot, etc.

Endpoints

GET

/api/v1/balance

balance_usd + recent ledger entries.

GET

/api/v1/catalog

Response includes balance_usd and payMethods id=balance.

POST

/api/v1/orders

You may pass "pay_currency": "balance" immediately.

POST

/api/v1/orders/{order_id}/pay

{ "pay_currency": "balance" } — charge prepaid balance.

Fields on balance payment

status

string

Usually paid / sending after charge.

pay_currency

string

balance

paid_from_balance

boolean

true

balance_charged_usd

number

Amount charged from balance.

balance_usd

number

Remaining balance after charge (on pay response).

wallet / amount

null

Not used for balance — null.

Balance errors

402 Insufficient balance — Not enough USD on the key.

400 Order is not payable — Order is no longer waiting / on_hold.

409 Balance payment already in progress — Duplicate pay on the same order.

curl examples

Balance

curl -s https://flashcryptoshop.com/api/v1/balance \
  -H "Authorization: Bearer fcs_YOUR_KEY"

Pay from balance

curl -s -X POST https://flashcryptoshop.com/api/v1/orders/FT-XXXX/pay \
  -H "Authorization: Bearer fcs_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pay_currency": "balance"}'

Classic per-order payment

Crypto and invoices (ton, usdt, cryptobot, stars…) stay available. If you omit balance, behaviour matches the main Reseller API.

Full Reseller API →

Top up balance

Message shop support with the amount and your key / reseller name. After the transfer, an admin credits USD to your balance.