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).
1. Offers List: GET /v1/offers
Section titled “1. Offers List: GET /v1/offers”Returns a paginated list of all active offers available to your workspace.
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 Parameters
Section titled “Query Parameters”| 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) |
Response Format 200 OK
Section titled “Response Format 200 OK”{ "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 }}Offer Fields Description
Section titled “Offer Fields Description”| 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.
curl -X GET "https://api.dandanpay.net/v1/offers/01981de8-7cb4-7f54-8672-57eb8ee8b47e" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"Response Format 200 OK
Section titled “Response Format 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": "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"}