Каталог офферов
Каталог DanDanPay формируется из предложений (офферов). Каждый оффер представляет конкретный номинал или пакет цифрового товара (например, Mobile Legends 50+50 Алмазов или Telegram Stars 50 шт.).
1. Список офферов: GET /v1/offers
Заголовок раздела «1. Список офферов: GET /v1/offers»Возвращает постраничный список всех доступных офферов воркспейса.
curl -X GET "https://api.dandanpay.net/v1/offers?brand_slug=mlbb&page=1&limit=20" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"Параметры запроса (Query)
Заголовок раздела «Параметры запроса (Query)»| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
page |
integer | 1 |
Номер страницы (начиная с 1) |
limit |
integer | 20 |
Количество офферов на странице (максимум 100) |
brand_slug |
string | — | Фильтр по бренду игры/сервиса (mlbb, genshin, steam и др.) |
product_slug |
string | — | Фильтр по типу продукта (crystals, diamonds, pass, topup) |
miniapp_id |
string (uuid) | — | Фильтр по идентификатору Telegram Mini App |
sort |
string | — | Поле сортировки (price, brand_title, offer_title) |
order |
string | asc |
Направление сортировки (asc, desc) |
Формат ответа 200 OK
Заголовок раздела «Формат ответа 200 OK»{ "results": [ { "id": "01981de8-7cb4-7f54-8672-57eb8ee8b47e", "brand_slug": "mlbb", "brand_title": "Mobile Legends: Bang Bang", "product_slug": "crystals", "product_title": "Кристаллы", "offer_title": "50+50", "offer_description": "Пакет 50 алмазов + 50 бонусных кристаллов", "disabled": false, "limited": true, "price": "1.0958", "unit_price": "0", "unit_quantity_field": null, "currency": "USD" }, { "id": "01981de8-7cb6-77e0-a2f0-3a174689750d", "brand_slug": "mlbb", "brand_title": "Mobile Legends: Bang Bang", "product_slug": "crystals", "product_title": "Кристаллы", "offer_title": "150+150", "offer_description": null, "disabled": false, "limited": true, "price": "3.2876", "unit_price": "0", "unit_quantity_field": null, "currency": "USD" } ], "meta": { "total": 42, "page": 1, "limit": 20 }}Описание полей оффера
Заголовок раздела «Описание полей оффера»| Поле | Тип | Описание |
|---|---|---|
id |
UUID | Уникальный ID оффера. Передается в offer_id при создании заказа |
brand_slug |
string | Кодовый идентификатор бренда (игры) |
brand_title |
string | Человекочитаемое название бренда |
product_slug |
string | Идентификатор типа продукта |
product_title |
string | Название продукта |
offer_title |
string | Название пакета / номинала |
price |
string | Фиксированная часть цены оффера в USD (decimal-строка, до 6 знаков после запятой без лишних нулей) |
unit_price |
string | Цена за дополнительную единицу количества (decimal-строка, до 6 знаков после запятой без лишних нулей) |
unit_quantity_field |
string / null | Имя поля из input, в котором передается количество для unit_price |
currency |
string | Валюта расчетов (всегда USD) |
disabled |
boolean | Флаг временной недоступности. Если true, оффер отображается в каталоге, но заказ создать нельзя |
limited |
boolean | Флаг персонально лимитированного оффера. Если true, перед созданием заказа необходимо проверить его доступность для получателя через POST /v1/orders/validate (limited_offers) |
2. Получение одного оффера: GET /v1/offers/{id}
Заголовок раздела «2. Получение одного оффера: GET /v1/offers/{id}»Возвращает детальную карточку оффера, включая order_input_schema — схему входных данных, требуемых при создании заказа.
curl -X GET "https://api.dandanpay.net/v1/offers/01981de8-7cb4-7f54-8672-57eb8ee8b47e" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"Формат ответа 200 OK
Заголовок раздела «Формат ответа 200 OK»{ "id": "01981de8-7cb4-7f54-8672-57eb8ee8b47e", "miniapp_id": null, "brand_slug": "mlbb", "brand_title": "Mobile Legends: Bang Bang", "product_slug": "crystals", "product_title": "Кристаллы", "offer_title": "50+50", "offer_description": null, "disabled": false, "limited": true, "order_input_schema": { "type": "object", "required": [ "game_user_key", "game_server_key" ], "properties": { "game_user_key": { "type": "string", "description": "ID игрока" }, "game_server_key": { "type": "string", "description": "Номер зоны/сервера" } }, "additionalProperties": false }, "price": "1.0958", "unit_price": "0", "unit_quantity_field": null, "currency": "USD"}