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

Быстрый старт (10 шагов)

Это руководство проведет вас через все этапы интеграции с DanDanPay Reseller API (/v1): от выпуска ключа доступа до подтверждения доставки первого заказа.


  1. Войдите в панель управления dash.dandanpay.net и создайте API-ключ для вашего магазина. Ключ передается во всех HTTP-запросах в заголовке Authorization: Bearer <API_KEY>.

  2. Проверьте баланс счетов воркспейса: GET /v1/accounts

    Заголовок раздела «Проверьте баланс счетов воркспейса: GET /v1/accounts»

    Убедитесь, что на счете в USD есть доступные средства:

    Окно терминала
    curl -X GET "https://api.dandanpay.net/v1/accounts" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Accept: application/json"

    Пример ответа:

    {
    "results": [
    {
    "id": "019818ab-1000-7c55-9477-5020aebf7001",
    "slug": "reseller_balance_usd",
    "available": "500",
    "frozen": "0",
    "currency": "USD"
    }
    ]
    }
  3. Настройте вебхуки для асинхронных уведомлений: POST /v1/webhooks

    Заголовок раздела «Настройте вебхуки для асинхронных уведомлений: POST /v1/webhooks»

    Для каждого типа событий зарегистрируйте URL на вашем сервере:

    • order.status_updated — изменение статуса заказа;
    • order.credentials_requested — запрос кода 2FA / ссылки подтверждения;
    • order.receipt-requested — доставка товара и ожидание подтверждения получения.
    Окно терминала
    curl -X POST "https://api.dandanpay.net/v1/webhooks" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
    "url": "https://api.myshop.com/webhooks/dandanpay",
    "event": "order.status_updated"
    }'
  4. Отправьте тестовое событие вебхука: POST /v1/webhooks/{id}/test

    Заголовок раздела «Отправьте тестовое событие вебхука: POST /v1/webhooks/{id}/test»

    Проверьте, что ваш веб-сервер корректно принимает POST-запросы и возвращает HTTP-код 200 OK:

    Окно терминала
    curl -X POST "https://api.dandanpay.net/v1/webhooks/123e4567-e89b-12d3-a456-426614174000/test" \
    -H "Authorization: Bearer YOUR_API_KEY"
  5. Получите список доступных предложений с фильтрацией по бренду или продукту:

    Окно терминала
    curl -X GET "https://api.dandanpay.net/v1/offers?brand_slug=mlbb&limit=20" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Accept: application/json"
    {
    "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",
    "price": "1.0958",
    "currency": "USD",
    "disabled": false,
    "limited": true
    }
    ],
    "meta": {
    "total": 1,
    "page": 1,
    "limit": 20
    }
    }
  6. Изучите схему параметров оффера: GET /v1/offers/{id}

    Заголовок раздела «Изучите схему параметров оффера: 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"
    {
    "id": "01981de8-7cb4-7f54-8672-57eb8ee8b47e",
    "price": "1.0958",
    "currency": "USD",
    "order_input_schema": {
    "type": "object",
    "required": ["game_user_key", "game_server_key"],
    "properties": {
    "game_user_key": { "type": "string" },
    "game_server_key": { "type": "string" }
    },
    "additionalProperties": false
    }
    }
  7. Передайте offer_id и объект input, соответствующий схеме order_input_schema:

    Окно терминала
    curl -X POST "https://api.dandanpay.net/v1/orders" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
    "offer_id": "01981de8-7cb4-7f54-8672-57eb8ee8b47e",
    "input": {
    "game_user_key": "1919293471",
    "game_server_key": "6956"
    }
    }'

    Ответ вернет 202 Accepted со статусом pending:

    {
    "id": "019818bc-1285-7c55-9477-5020aebf7782",
    "offer_id": "01981de8-7cb4-7f54-8672-57eb8ee8b47e",
    "status": "pending",
    "price": "1.0958",
    "currency": "USD"
    }
  8. В любой момент можно запросить актуальное состояние заказа:

    Окно терминала
    curl -X GET "https://api.dandanpay.net/v1/orders/019818bc-1285-7c55-9477-5020aebf7782" \
    -H "Authorization: Bearer YOUR_API_KEY"
  9. Если выполнение требует входа в аккаунт, вам придет вебхук order.credentials_requested. Передайте код клиента методом:

    Окно терминала
    curl -X POST "https://api.dandanpay.net/v1/orders/019818bc-1285-7c55-9477-5020aebf7782/credentials" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
    "type": "otp",
    "code": "849201"
    }'
  10. Подтвердите получение товара или откройте спор

    Заголовок раздела «Подтвердите получение товара или откройте спор»

    Когда товар доставлен, поступает вебхук order.receipt-requested (содержит delivered_at и auto_confirm_at). Подтвердите завершение:

    Окно терминала
    curl -X POST "https://api.dandanpay.net/v1/orders/019818bc-1285-7c55-9477-5020aebf7782/confirm-receipt" \
    -H "Authorization: Bearer YOUR_API_KEY"

    Или откройте диспут, если товар не поступил:

    Окно терминала
    curl -X POST "https://api.dandanpay.net/v1/orders/019818bc-1285-7c55-9477-5020aebf7782/dispute" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
    "reason": "Кристаллы не поступили на игровой аккаунт"
    }'