Перейти к содержимому
Дашборд

Каталог офферов

Каталог DanDanPay формируется из предложений (офферов). Каждый оффер представляет конкретный номинал или пакет цифрового товара (например, Mobile Legends 50+50 Алмазов или Telegram Stars 50 шт.).


Возвращает постраничный список всех доступных офферов воркспейса.

Окно терминала
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"
Параметр Тип По умолчанию Описание
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)

{
"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)

Возвращает детальную карточку оффера, включая 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"
{
"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"
}