Документация Datamoll Provider API

Official SDKs

Official SDKs for server-side integrations

Recommended path

SDK simplifies Provider API integration

Use it when you want to connect Datamoll catalog and order creation to your server-side app without hand-writing authorization, idempotency, pagination, retries, error handling, and order recovery after timeouts.

Best for: new stores, bot shops, SaaS panels, forum modules, and partner dashboards.
Still yours: local catalog UI, payments, customer delivery screen, and order storage.
Boundary: Use the SDK only in server-side code you control: Provider keys stay on the server, and the client interface calls your API.

Node.js / TypeScript

For Node.js storefronts and bots

Choose this when the server side already runs on Next.js API routes, NestJS, Express, Telegraf, grammY, Discord.js, or background jobs.

Best for web stores, Telegram/Discord bots, SaaS panels, and background jobs.

You get typed client, OpenAPI types, checkout recovery retries, polling helpers, request_id, retry classification, and retry-after helpers.

Open Node.js example->

Python async

For Telegram shops and scheduled sync

Choose this for aiogram bots, FastAPI services, async tasks, and scheduled catalog or reconciliation jobs.

Best for Telegram stores, FastAPI dashboards, background jobs, catalog sync, and balance reconciliation.

You get async HTTP client, Pydantic response validation, order recovery, disputes, and polling helpers.

Open Python example->

PHP

For forums, CMS, and existing PHP shops

Choose this when the project already runs on PHP and needs Datamoll without a separate Node.js or Python service.

Best for forum engines, CMS modules, reseller panels, custom PHP stores, and existing shop server code.

You get Composer package, request validation, order recovery, disputes, transactions, and OpenAPI-based PHPDoc types.

Open PHP example->

Методы

Выберите API-метод

Рекомендуемый

Нативный JSON API

Datamoll External Provider API

JSON API с синхронизацией каталога, локализованными данными товаров, синхронной выдачей credentials, восстановлением заказов и созданием споров.

Когда использовать: Вы строите новую интеграцию или можете перейти на JSON-контракт.
Авторизация: X-Provider-Key с выданными api_key и api_secret.
Покупка: POST /orders синхронно возвращает купленные credentials.
Контракт: JSON-ответы, OpenAPI-схемы, локализованный каталог и синхронизация через updated_since.

Базовый адрес: /api/v1/provider

Режим совместимости

Протокол Accsmoll

Accsmoll Commerce

Совместимый контракт для партнеров, у которых уже работает Accsmoll-клиент и нужен минимальный переход.

Когда использовать: Ваш текущий клиент ожидает ключи методов Accsmoll и схему оплаты через счет.
Авторизация: Публичный/приватный LEQUE-заголовок и ключи отдельных методов.
Покупка: createorder -> paybalance -> checkpayment -> downloadtxt.
Контракт: Товары, витринные endpoint'ы и форматы ответов в совместимой форме Accsmoll.

Базовый адрес: /api/v1/provider/accsmoll

Режим совместимости

ACG-Faka / 店铺共享

ACG-Faka

Профиль совместимости для магазинов ACG-Faka, где Datamoll добавляется как внешний общий магазин в 店铺共享.

Когда использовать: Магазин уже работает на ACG-Faka и принимает внешние общие магазины через 店铺共享.
Авторизация: app_id, app_key и нативная MD5-подпись в form-запросах.
Покупка: items -> inventoryState -> trade -> query.
Контракт: ACG-совместимые конверты общего магазина, суммы в CNY и списания Datamoll в USD.

Базовый адрес: https://acg.datamollcore.com

Документация

Откройте документацию выбранного метода

Рекомендуемый

Нативный JSON API

Datamoll External Provider API

JSON API с синхронизацией каталога, локализованными данными товаров, синхронной выдачей credentials, восстановлением заказов и созданием споров.

SDK Быстрый старт SDK Установите Node.js, Python или PHP SDK и запустите первые серверные сценарии: каталог, заказ, спор и сверку. -> REF Справочник API Операции, схемы, заголовки, примеры и ошибки, сгруппированные по Account, Catalog, Orders и Disputes. -> YAML Контракт OpenAPI Машиночитаемый OpenAPI-контракт для генерации клиентов, проверки схем и интеграционного ревью. -> GUIDE Инструкция запуска Порядок запуска, правила повторов и восстановления, опрос до webhooks и production-чеклист. ->

Режим совместимости

Протокол Accsmoll

Accsmoll Commerce

Режим для существующих клиентов Accsmoll API Commerce, которые не могут быстро перейти на новый контракт.

REF Справочник совместимости Справочник по Accsmoll-совместимым endpoint'ам: ключи методов, LEQUE-заголовки, чтение каталога, цепочка счета, оплата с баланса и форматы ответов. -> YAML Контракт OpenAPI Машиночитаемый OpenAPI-контракт профиля совместимости Accsmoll для генерации клиента и интеграционного ревью. -> GUIDE Инструкция запуска Выдача учетных данных, настройка ключей и LEQUE-заголовков, цепочка счета, восстановление через checkpayment/downloadtxt и чеклист запуска. ->

Режим совместимости

ACG-Faka / 店铺共享

ACG-Faka

Профиль совместимости для магазинов ACG-Faka, где Datamoll добавляется как внешний общий магазин в 店铺共享.

GUIDE PDF-инструкция запуска Подключение через 店铺共享 -> 新增店铺, импорт через 接入货源, синхронизация, наценка, споры по проблемным заказам и чеклист запуска. ->

Datamoll External:       https://datamollcore.com/api/v1/provider
Accsmoll Commerce:      https://datamollcore.com/api/v1/provider/accsmoll
ACG-Faka:  https://acg.datamollcore.com