Skip to content
Dashboard

Offers Catalog

The DanDanPay catalog consists of individual offers. Each offer represents a specific denomination or package of digital goods (for example, Mobile Legends 50+50 Diamonds or Telegram Stars 50 pcs).


Returns a paginated list of all active offers available to your workspace.

Terminal window
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"
Parameter Type Default Description
page integer 1 Page number (starting from 1)
limit integer 20 Number of offers per page (maximum 100)
brand_slug string — Filter by game/service brand (mlbb, genshin, steam, etc.)
product_slug string — Filter by product type (crystals, diamonds, pass, topup)
miniapp_id string (uuid) — Filter by Telegram Mini App identifier
sort string — Sort field (price, brand_title, offer_title)
order string asc Sort direction (asc, desc)

{
"results": [
{
"id": "01981de8-7cb4-7f54-8672-57eb8ee8b47e",
"brand_slug": "mlbb",
"brand_title": "Mobile Legends: Bang Bang",
"product_slug": "crystals",
"product_title": "Crystals",
"offer_title": "50+50",
"offer_description": "50 diamonds + 50 bonus crystals pack",
"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": "Crystals",
"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
}
}
Field Type Description
id UUID Unique offer ID. Passed as offer_id when creating an order
brand_slug string Identifier code of the brand (game)
brand_title string Human-readable brand name
product_slug string Product category identifier
product_title string Product category title
offer_title string Package name or denomination
price string Fixed price component in USD (decimal string, up to 6 decimal places without trailing zeros)
unit_price string Price per additional unit for variable quantity goods (decimal string, up to 6 decimal places without trailing zeros)
unit_quantity_field string / null Field name from input specifying quantity for unit_price
currency string Settlement currency (always USD)
disabled boolean Availability flag. If true, offer is visible but orders cannot be placed
limited boolean Personal limit flag. If true, check availability for the recipient via POST /v1/orders/validate (limited_offers) before placing an order

2. Retrieve Single Offer: GET /v1/offers/{id}

Section titled “2. Retrieve Single Offer: GET /v1/offers/{id}”

Returns detailed information about an offer, including its order_input_schema — the JSON schema required for order placement.

Terminal window
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": "Crystals",
"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": "Player ID"
},
"game_server_key": {
"type": "string",
"description": "Zone / Server ID"
}
},
"additionalProperties": false
},
"price": "1.0958",
"unit_price": "0",
"unit_quantity_field": null,
"currency": "USD"
}