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

Архитектура и статусы

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
│
▼
[ Сервер обработки партнера ]

Каждый B2B-партнер работает в рамках изолированного пространства — Workspace:

  • К воркспейсу привязаны балансовые счета (accounts), на которых хранятся доступные (available) и заблокированные под выполняющиеся заказы (frozen) средства.
  • API-ключи создаются на уровне воркспейса. Запрос с валидным ключом автоматически идентифицирует ваш магазин.
  • Заказы, офферы и подписки на вебхуки строго изолированы между воркспейсами.

В 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.

С этого момента активируются следующие сценарии:

  1. Подтверждение покупателем: партнер вызывает POST /v1/orders/{id}/confirm-receipt. В заказе фиксируется client_confirmed_at, заказ переходит в статус completed.
  2. Открытие спора: если клиент сообщает, что товар не поступил, партнер вызывает POST /v1/orders/{id}/dispute. В заказе фиксируется disputed_at, таймер автоподтверждения останавливается, а заказ передается в арбитраж поставщика.
  3. Автоподтверждение по дедлайну (auto_confirm_at): поле задает предельный срок (SLA), до которого клиент обязан заявить претензию. Если партнер не вызвал ни confirm-receipt, ни dispute, заказ автоматически закрывается со статусом completed.

Если заказ переходит в статус 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 — товар закончился у поставщика.