Prepaid-баланс реселлера

У каждого API-ключа есть prepaid-баланс в USD. Админ магазина зачисляет сумму после вашего перевода. Дальше ордера можно оплачивать с баланса без ручной крипты на каждый заказ.

Пополнение только через админа магазина. В API нет self-top-up — только чтение баланса и оплата ордеров.

Как это работает

Вы переводите магазину деньги (крипта / перевод) — как договоритесь с поддержкой.
Админ в панели реселлеров нажимает «Пополнить баланс» на ваш ключ.
GET /api/v1/balance или catalog показывает balance_usd.
POST /api/v1/orders или …/pay с pay_currency=balance — списывается usd_value, статус paid, токены уходят на address.
Если баланса мало — 402 Insufficient balance. Тогда платите как раньше: ton, cryptobot и т.д.

Эндпоинты

GET

/api/v1/balance

balance_usd + ledger последних движений.

GET

/api/v1/catalog

В ответе balance_usd и payMethods с id=balance.

POST

/api/v1/orders

Можно сразу "pay_currency": "balance".

POST

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

{ "pay_currency": "balance" } — оплата с баланса.

Поля ответа при оплате с баланса

status

string

Обычно paid / sending после списания.

pay_currency

string

balance

paid_from_balance

boolean

true

balance_charged_usd

number

Сколько сняли с баланса.

balance_usd

number

Остаток после списания (в ответе pay).

wallet / amount

null

Для balance не нужны — null.

Ошибки баланса

402 Insufficient balance — Не хватает USD на ключе.

400 Order is not payable — Заказ уже не waiting / on_hold.

409 Balance payment already in progress — Повторный pay на тот же ордер.

Примеры curl

Баланс

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

Оплатить с баланса

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"}'

Обычная оплата ордера

Крипта и инвойсы (ton, usdt, cryptobot, stars…) не убраны. Если не передаёте balance — всё как в основной Reseller API.

Полная Reseller API →

Пополнить баланс

Напишите в поддержку магазина: сумма и ваш ключ / имя реселлера. После перевода админ зачислит USD на баланс.