Архитектура и статусы
DanDanPay Reseller API спроектирован как высоконадежный шлюз между платформами электронной коммерции и поставщиками цифровых товаров.
[ Партнерский сервис / Витрина ] │ Authorization: Bearer <API_KEY> │ ▼┌──────────────────────────────────────────────────────────────┐│ DanDanPay Reseller API (/v1) ││ ││ • Проверка API-ключа и привязка к Workspace ││ • Валидация входных данных через JSON Schema оффера ││ • Проверка баланса счета воркспейса в USD ││ • Умный роутинг на оптимального поставщика ││ • Мониторинг SLA и доставка вебхуков │└──────────────┬───────────────────────────────┬───────────────┘ │ │ ▼ ▼ [ Внешний поставщик / Шлюз ] [ Арбитраж и поддержка ] │ ▼ [ Webhooks с HMAC-SHA256 ] • order.status_updated • order.credentials_requested • order.receipt-requested │ ▼ [ Сервер обработки партнера ]Воркспейсная изоляция (Workspaces)
Заголовок раздела «Воркспейсная изоляция (Workspaces)»Каждый B2B-партнер работает в рамках изолированного пространства — Workspace:
- К воркспейсу привязаны балансовые счета (
accounts), на которых хранятся доступные (available) и заблокированные под выполняющиеся заказы (frozen) средства. - API-ключи создаются на уровне воркспейса. Запрос с валидным ключом автоматически идентифицирует ваш магазин.
- Заказы, офферы и подписки на вебхуки строго изолированы между воркспейсами.
Жизненный цикл заказа (State Machine)
Заголовок раздела «Жизненный цикл заказа (State Machine)»В API статус заказа принимает одно из 5 фиксированных значений:
Статус (status) |
Тип статуса | Описание |
|---|---|---|
pending |
Промежуточный | Заказ создан, средства захолдированы на балансе, заказ ожидает передачи поставщику. |
processing |
Промежуточный | Заказ передан в обработку поставщику или автоматическому шлюзу пополнения. |
completed |
Конечный | Заказ успешно выполнен, подтвержден и завершен. Средства списаны с баланса. |
error |
Возобновляемый | Произошла временная ошибка исполнения (может быть автоматически перезапущен в pending). |
failed |
Конечный | Заказ не может быть выполнен (неверные данные, отказ поставщика). Средства возвращены на баланс. |
[ POST /v1/orders ] │ ▼ [ pending ] ◄──────────┐ │ │ ▼ │ (авторетрай) [ processing ] ────► [ error ] │ │ ├─────────────────┴─────► [ failed ] (конечный) │ (товар отгружен: delivered_at) │ ▼ ┌───────────────────────────────────────────────────────────┐ │ Ожидание подтверждения покупателя │ │ │ │ • POST /v1/orders/{id}/confirm-receipt ──► [ completed ]│ │ • Истечение auto_confirm_at (SLA) ──► [ completed ]│ │ • POST /v1/orders/{id}/dispute ──► [ dispute ] │ └───────────────────────────────────────────────────────────┘Механизм подтверждения доставки и споры
Заголовок раздела «Механизм подтверждения доставки и споры»После того как поставщик отгрузил товар клиенту, в объекте заказа заполняется поле delivered_at и на сервер партнера отправляется вебхук order.receipt-requested.
С этого момента активируются следующие сценарии:
- Подтверждение покупателем: партнер вызывает
POST /v1/orders/{id}/confirm-receipt. В заказе фиксируетсяclient_confirmed_at, заказ переходит в статусcompleted. - Открытие спора: если клиент сообщает, что товар не поступил, партнер вызывает
POST /v1/orders/{id}/dispute. В заказе фиксируетсяdisputed_at, таймер автоподтверждения останавливается, а заказ передается в арбитраж поставщика. - Автоподтверждение по дедлайну (
auto_confirm_at): поле задает предельный срок (SLA), до которого клиент обязан заявить претензию. Если партнер не вызвал ниconfirm-receipt, ниdispute, заказ автоматически закрывается со статусомcompleted.
Структура ошибки reason
Заголовок раздела «Структура ошибки reason»Если заказ переходит в статус error или failed, в объекте заказа возвращается поле reason:
{ "status": "failed", "reason": { "code": "PURCHASE_LIMIT_EXCEEDED", "message": "Purchase limit exceeded for this product or account" }}Типовые коды ошибок:
PURCHASE_LIMIT_EXCEEDED— превышен лимит покупок на аккаунте игрока.INVALID_CREDENTIALS— предоставленные логин/пароль/OTP не подошли.SERVER_UNAVAILABLE— игровой сервер временно на техработах.OUT_OF_STOCK— товар закончился у поставщика.