flashtoken.shop

Reseller API · v1

Продавайте через свой сайт или бот

Создайте ключ, подключите четыре метода и получайте 30% с каждой успешно завершённой продажи.

Проверка ключа

HTTPS · JSON

curl https://flashtoken.shop/api/reseller/v1/account \
  -H "Authorization: Bearer YOUR_API_KEY"

Храните ключ только на сервере, не в браузерном JavaScript.

Ваши реквизиты

Клиент платит по методам FlashToken. Реселлер не может подменить реквизиты.

30% с продажи

Комиссия считается после выдачи. Выплачивает её владелец сервиса вручную.

Защищённый доступ

Ключ хранится в виде хеша, действуют лимиты и изоляция заказов.

Доступ

Создать API-ключ

Ключ показывается один раз. Сразу скопируйте и сохраните его.

Интеграция

Полный цикл заказа

Базовый URL: https://flashtoken.shop/api/reseller/v1. Все ответы приходят в JSON, авторизация передаётся заголовком Bearer.

GET

1. Получите каталог

Берите идентификаторы товара и сети только из актуального ответа каталога.

curl https://flashtoken.shop/api/reseller/v1/products \
  -H "Authorization: Bearer YOUR_API_KEY"
POST

2. Создайте заказ

Передайте товар, сеть, количество и адрес получения. Сохраните ID заказа и ссылку на оплату из ответа.

curl -X POST https://flashtoken.shop/api/reseller/v1/orders \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-10001" \
  -d '{
    "product": "PRODUCT_ID",
    "delivery_network": "NETWORK",
    "amount": 10,
    "bsc_address": "CUSTOMER_WALLET"
  }'

Используйте уникальный Idempotency-Key для каждой покупки, чтобы повтор запроса не создал дубликат.

GET

3. Проверяйте статус

Проверяйте заказ не чаще одного раза в 5–10 секунд и остановитесь на конечном статусе.

curl https://flashtoken.shop/api/reseller/v1/orders/ORDER_ID \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "id": "order_...",
  "status": "completed",
  "payment_status": "paid",
  "tx_hash": "0x...",
  "commission_percent": 30,
  "commission_amount": 3
}

Методы API

Справочник эндпоинтов

Каталог

Товары, сети, цены и ограничения.

GET

/products

Новый заказ

Создание заказа и получение ссылки на оплату.

POST

/orders

Статус заказа

Оплата, выдача, tx hash и комиссия.

GET

/orders/{id}

Статистика

Продажи, заработок и сумма к выплате.

GET

/account

Статусы

Что показывать клиенту

waiting

Заказ создан и ожидает оплату клиента.

on_hold

Оплата или заказ проверяются. Не создавайте дубликат.

paid / sending

Оплата найдена, товар готовится к выдаче.

completed

Заказ выдан, комиссия 30% начислена.

cancelled / expired

Заказ отменён или время оплаты истекло.

Ограничения

Защита от злоупотреблений

180 запросов/мин

— чтение на один API-ключ

10 заказов/мин

— краткосрочный лимит

30 заказов/час

— почасовое ограничение

100 заказов/день

— суточное ограничение

20 активных

— максимум незавершённых заказов

Оплата и комиссия

Деньги поступают на реквизиты FlashToken

Платёжная страница использует способы оплаты владельца FlashToken. API не раскрывает платёжные токены, настройки мерчанта или чужие заказы.

30% начисляются после статуса completed. Сервис ведёт учёт, а владелец самостоятельно выплачивает заработок реселлеру.