Быстрый старт (10 шагов)
Это руководство проведет вас через все этапы интеграции с DanDanPay Reseller API (/v1): от выпуска ключа доступа до подтверждения доставки первого заказа.
-
Получите API-ключ воркспейса
Заголовок раздела «Получите API-ключ воркспейса»Войдите в панель управления dash.dandanpay.net и создайте API-ключ для вашего магазина. Ключ передается во всех HTTP-запросах в заголовке
Authorization: Bearer <API_KEY>. -
Проверьте баланс счетов воркспейса:
Заголовок раздела «Проверьте баланс счетов воркспейса: 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"}]} -
Настройте вебхуки для асинхронных уведомлений:
Заголовок раздела «Настройте вебхуки для асинхронных уведомлений: 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"}' -
Отправьте тестовое событие вебхука:
Заголовок раздела «Отправьте тестовое событие вебхука: 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" -
Запросите каталог офферов:
Заголовок раздела «Запросите каталог офферов: GET /v1/offers»GET /v1/offersПолучите список доступных предложений с фильтрацией по бренду или продукту:
Окно терминала 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}} -
Изучите схему параметров оффера:
Заголовок раздела «Изучите схему параметров оффера: 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}} -
Создайте заказ:
Заголовок раздела «Создайте заказ: POST /v1/orders»POST /v1/ordersПередайте
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"} -
Проверьте статус заказа:
Заголовок раздела «Проверьте статус заказа: GET /v1/orders/{id}»GET /v1/orders/{id}В любой момент можно запросить актуальное состояние заказа:
Окно терминала curl -X GET "https://api.dandanpay.net/v1/orders/019818bc-1285-7c55-9477-5020aebf7782" \-H "Authorization: Bearer YOUR_API_KEY" -
Передайте 2FA / OTP-код (при запросе)
Заголовок раздела «Передайте 2FA / OTP-код (при запросе)»Если выполнение требует входа в аккаунт, вам придет вебхук
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"}' -
Подтвердите получение товара или откройте спор
Заголовок раздела «Подтвердите получение товара или откройте спор»Когда товар доставлен, поступает вебхук
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": "Кристаллы не поступили на игровой аккаунт"}'