Partner API — REST API for Resellers | Marix | Маркет Цифровая Машка

Авторизация

8 эндпоинтов

POST/api/access/login

Login

Стандартный вход по логину и паролю. Возвращает HTTP 204 и устанавливает сессионный cookie. Используйте, когда у клиента уже есть пара credentials.

Параметры

Имя	Где	Тип	Обяз.
`x-language`	header	Language \| null	нет

Тело запроса LoginIn

cURL

curl -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-language: <x-language>" \
  -H "Content-Type: application/json" \
  https://api.marix.cc/api/access/login \
  -d '{
  "username": "username",
  "password": "password"
}'

GET/api/access/login-code

Login With Code

Одноразовая авторизация по магической ссылке. Партнёр получает code на email или в чате и обменивает его на сессию. Удобно для бесшовного входа из писем и push-уведомлений.

Параметры

Имя	Где	Тип	Обяз.
`code`	query	string	да
`returnUrl`	query	string (uri) \| null	нет
`x-language`	header	Language \| null	нет

cURL

curl -X GET \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-language: <x-language>" \
  https://api.marix.cc/api/access/login-code?code=<code>&returnUrl=<returnUrl?>

POST/api/access/logout

Logout

Завершает сессию и инвалидирует cookie. Вызывайте при выходе пользователя или смене аккаунта.

Параметры

Имя	Где	Тип	Обяз.
`x-language`	header	Language \| null	нет

cURL

curl -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-language: <x-language>" \
  https://api.marix.cc/api/access/logout

GET/api/access/me

Get Me

Профиль текущего пользователя: id, email, имя, права доступа. Стандартный способ проверить сессию и подгрузить данные для UI.

Параметры

Имя	Где	Тип	Обяз.
`x-language`	header	Language \| null	нет

cURL

curl -X GET \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-language: <x-language>" \
  https://api.marix.cc/api/access/me

Ответ 200 UserOut

{
  "email": "string",
  "telegramId": 0,
  "telegramUsername": "string",
  "firstName": "string",
  "lastName": "string",
  "isActive": false,
  "isSuper": false
}

GET/api/access/me/balances/

Get My Balances

Балансы текущего пользователя в разных валютах (RUB, USD, USDT). Нужен для дашборда и проверки доступности оплаты с баланса перед созданием заказа.

Параметры

Имя	Где	Тип	Обяз.
`x-language`	header	Language \| null	нет

cURL

curl -X GET \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-language: <x-language>" \
  https://api.marix.cc/api/access/me/balances/

Ответ 200 UserBalanceOut[]

[
  {
    "currency": "rub",
    "available": "available",
    "reserved": "reserved",
    "pending": "pending"
  }
]

POST/api/access/register

User Register

Создание нового аккаунта по email и паролю. После регистрации можно сразу логиниться через /login или сделать magic-link через /login-code.

Параметры

Имя	Где	Тип	Обяз.
`x-language`	header	Language \| null	нет

Тело запроса RegisterIn

cURL

curl -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-language: <x-language>" \
  -H "Content-Type: application/json" \
  https://api.marix.cc/api/access/register \
  -d '{
  "email": "partner@example.com",
  "password": "password"
}'

Ответ 202 MessageOut

{
  "message": "message"
}

GET/api/access/google/login

Google Login

Старт OAuth-флоу через Google. Возвращает 302 на страницу авторизации Google — встройте редирект в свой UI или откройте в popup.

Параметры

Имя	Где	Тип	Обяз.
`returnUrl`	query	string (uri) \| null	нет
`mode`	query	SsoAuthMode	нет
`x-language`	header	Language \| null	нет

cURL

curl -X GET \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-language: <x-language>" \
  https://api.marix.cc/api/access/google/login?returnUrl=<returnUrl?>&mode=<mode?>

POST/api/access/google/callback/token

Google Callback Token

Финальный шаг OAuth: меняет временный code, полученный от Google после редиректа, на наш сессионный cookie.

Параметры

Имя	Где	Тип	Обяз.
`x-language`	header	Language \| null	нет

Тело запроса SsoTokenLoginIn

cURL

curl -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-language: <x-language>" \
  -H "Content-Type: application/json" \
  https://api.marix.cc/api/access/google/callback/token \
  -d '{
  "state": "state",
  "token": "token"
}'

Каталог

6 эндпоинтов

GET/api/categories/

Get Categories

Полный список товарных категорий: игры, подписки, eSIM, виртуальные карты и т.д. Используйте для построения главной страницы каталога или категорийного меню.

Параметры

Имя	Где	Тип	Обяз.
`limit`	query	integer	нет
`offset`	query	integer	нет
`parent_id_or_slug`	query	string \| null	нет
`x-language`	header	Language \| null	нет

cURL

curl -X GET \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-language: <x-language>" \
  https://api.marix.cc/api/categories/?limit=<limit?>&offset=<offset?>&parent_id_or_slug=<parent_id_or_slug?>

GET/api/categories/{category_id_or_slug}

Get Category

Детальная информация о категории: название, описание, атрибуты, ссылки на родителя, теги. Поддерживает как UUID, так и человекочитаемый slug.

Параметры

Имя	Где	Тип	Обяз.
`category_id_or_slug`	path	string	да
`x-language`	header	Language \| null	нет

cURL

curl -X GET \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-language: <x-language>" \
  https://api.marix.cc/api/categories/:category_id_or_slug

Ответ 200 CategoryOut

{
  "id": "019ad428-e9cd-7982-a6fa-0ec0eebce25d",
  "name": "name",
  "slug": "slug",
  "description": "string",
  "bestOfferPrice": "string",
  "attributes": {},
  "attributeDefinitions": [
    {
      "name": "name",
      "type": "bool",
      "description": "description",
      "required": false
    }
  ],
  "tags": [
    "string"
  ],
  "parentId": "019ad428-e9cd-7982-a6fa-0ec0eebce25d",
  "imagePath": "string",
  "thumbnailPath": "string",
  "hasProducts": false
}

GET/api/categories/{category_id_or_slug}/options/recent

Get Recent Category Option Values

Недавно использованные значения категорийных опций — например, последние выбранные регионы или платформы. Используйте для подсказок и автокомплита в форме заказа.

Параметры

Имя	Где	Тип	Обяз.
`category_id_or_slug`	path	string	да
`option`	query	string	да
`limit`	query	integer	нет
`x-language`	header	Language \| null	нет

cURL

curl -X GET \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-language: <x-language>" \
  https://api.marix.cc/api/categories/:category_id_or_slug/options/recent?option=<option>&limit=<limit?>

Ответ 200 CategoryRecentOptionOut[]

[
  {
    "value": "value",
    "count": 0,
    "lastUsedAt": "2026-05-14T10:30:00Z"
  }
]

GET/api/products/

Get Products

Листинг товаров с фильтрами по категории, цене и наличию. Основной эндпоинт для каталожной выдачи с пагинацией и сортировкой.

Параметры

Имя	Где	Тип	Обяз.
`limit`	query	integer	нет
`offset`	query	integer	нет
`category_id_or_slug`	query	string	да
`x-language`	header	Language \| null	нет

cURL

curl -X GET \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-language: <x-language>" \
  https://api.marix.cc/api/products/?limit=<limit?>&offset=<offset?>&category_id_or_slug=<category_id_or_slug>

Ответ 200 OffsetPagination_ProductOut_

{
  "items": [
    {
      "id": "019ad428-e9cd-7982-a6fa-0ec0eebce25d",
      "name": "name",
      "slug": "slug",
      "description": "string",
      "attributes": {},
      "isService": false,
      "categoryId": "019ad428-e9cd-7982-a6fa-0ec0eebce25d",
      "imagePath": "string",
      "thumbnailPath": "string",
      "offers": [
        {
          "id": null,
          "price": null,
          "pricePerQuantity": null,
          "availableQuantity": null,
          "orderMinQuantity": null,
          "orderMaxQuantity": null,
          "orderQuantityMultiple": null,
          "requiredNoteFields": null,
          "productId": null
        }
      ]
    }
  ],
  "limit": 0,
  "offset": 0,
  "total": 0
}

GET/api/products/search

Search Products

Поиск товаров по подстроке в названии и описании. Возвращает ранжированный список — удобно для строки поиска в шапке или подсказок при наборе.

Параметры

Имя	Где	Тип	Обяз.
`query`	query	string	да
`category_id_or_slug`	query	string \| null	нет
`limit`	query	integer	нет
`x-language`	header	Language \| null	нет

cURL

curl -X GET \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-language: <x-language>" \
  https://api.marix.cc/api/products/search?query=<query>&category_id_or_slug=<category_id_or_slug?>&limit=<limit?>

Ответ 200 ProductOut[]

[
  {
    "id": "019ad428-e9cd-7982-a6fa-0ec0eebce25d",
    "name": "name",
    "slug": "slug",
    "description": "string",
    "attributes": {},
    "isService": false,
    "categoryId": "019ad428-e9cd-7982-a6fa-0ec0eebce25d",
    "imagePath": "string",
    "thumbnailPath": "string",
    "offers": [
      {
        "id": "019ad428-e9cd-7982-a6fa-0ec0eebce25d",
        "price": "price",
        "pricePerQuantity": 0,
        "availableQuantity": 0,
        "orderMinQuantity": 0,
        "orderMaxQuantity": null,
        "orderQuantityMultiple": 0,
        "requiredNoteFields": [
          null
        ],
        "productId": "019ad428-e9cd-7982-a6fa-0ec0eebce25d"
      }
    ]
  }
]

GET/api/products/{product_id_or_slug}

Get Product

Детальная карточка товара: характеристики, варианты офферов (номиналы, регионы), цены, остатки на складе. Запросите перед открытием формы заказа.

Параметры

Имя	Где	Тип	Обяз.
`product_id_or_slug`	path	string	да
`x-language`	header	Language \| null	нет

cURL

curl -X GET \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-language: <x-language>" \
  https://api.marix.cc/api/products/:product_id_or_slug

Ответ 200 ProductOut

{
  "id": "019ad428-e9cd-7982-a6fa-0ec0eebce25d",
  "name": "name",
  "slug": "slug",
  "description": "string",
  "attributes": {},
  "isService": false,
  "categoryId": "019ad428-e9cd-7982-a6fa-0ec0eebce25d",
  "imagePath": "string",
  "thumbnailPath": "string",
  "offers": [
    {
      "id": "019ad428-e9cd-7982-a6fa-0ec0eebce25d",
      "price": "price",
      "pricePerQuantity": 0,
      "availableQuantity": 0,
      "orderMinQuantity": 0,
      "orderMaxQuantity": 0,
      "orderQuantityMultiple": 0,
      "requiredNoteFields": [
        "string"
      ],
      "productId": "019ad428-e9cd-7982-a6fa-0ec0eebce25d"
    }
  ]
}

Заказы

7 эндпоинтов

GET/api/orders/

List Orders

Список заказов текущего пользователя или партнёра. Поддерживает фильтры по статусу, периоду, способу оплаты, методу выдачи.

Параметры

Имя	Где	Тип	Обяз.
`statuses`	query	CommaSeparatedValue_OrderStatus_ \| null	нет
`limit`	query	integer	нет
`offset`	query	integer	нет
`x-language`	header	Language \| null	нет

cURL

curl -X GET \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-language: <x-language>" \
  https://api.marix.cc/api/orders/?statuses=<statuses?>&limit=<limit?>&offset=<offset?>

Ответ 200 OffsetPagination_OrderSummaryOut_

{
  "items": [
    {
      "id": "019ad428-e9cd-7982-a6fa-0ec0eebce25d",
      "price": "price",
      "isMock": false,
      "status": "active",
      "cancelReason": "payment_failure",
      "createdAt": "2026-05-14T10:30:00Z",
      "paymentExpiresAt": "2026-05-14T10:30:00Z"
    }
  ],
  "limit": 0,
  "offset": 0,
  "total": 0
}

POST/api/orders/

Create Order

Создание нового заказа. Принимает productId, offerId и параметры выдачи (email, никнейм игрока, регион). Возвращает orderId для последующей оплаты или активации.

Параметры

Имя	Где	Тип	Обяз.
`x-language`	header	Language \| null	нет

Тело запроса OrderCreateIn

cURL

curl -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-language: <x-language>" \
  -H "Content-Type: application/json" \
  https://api.marix.cc/api/orders/ \
  -d '{
  "email": "partner@example.com",
  "items": [
    {
      "offerId": "019ad428-e9cd-7982-a6fa-0ec0eebce25d",
      "itemId": "string",
      "quantity": 0,
      "totalPrice": 0,
      "note": {}
    }
  ],
  "isMock": false
}'

Ответ 200 OrderOut

{
  "id": "019ad428-e9cd-7982-a6fa-0ec0eebce25d",
  "price": "price",
  "isMock": false,
  "status": "active",
  "cancelReason": "payment_failure",
  "createdAt": "2026-05-14T10:30:00Z",
  "items": [
    {
      "offer": {
        "id": "019ad428-e9cd-7982-a6fa-0ec0eebce25d"
      },
      "product": {
        "id": "019ad428-e9cd-7982-a6fa-0ec0eebce25d",
        "name": "name",
        "userGuide": null,
        "attributes": {},
        "isService": false,
        "categoryId": "019ad428-e9cd-7982-a6fa-0ec0eebce25d"
      },
      "quantity": 0,
      "externalData": [
        "string"
      ],
      "error": "string"
    }
  ],
  "paymentExpiresAt": "2026-05-14T10:30:00Z"
}

POST/api/orders/redeem

Create Order From Coupon

Создание заказа по купону. Используйте для подарочных карт и промо-кампаний — товар активируется напрямую без обычной оплаты.

Параметры

Имя	Где	Тип	Обяз.
`x-language`	header	Language \| null	нет

Тело запроса OrderRedeemCouponIn

cURL

curl -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-language: <x-language>" \
  -H "Content-Type: application/json" \
  https://api.marix.cc/api/orders/redeem \
  -d '{
  "code": "code"
}'

Ответ 200 OrderOut

{
  "id": "019ad428-e9cd-7982-a6fa-0ec0eebce25d",
  "price": "price",
  "isMock": false,
  "status": "active",
  "cancelReason": "payment_failure",
  "createdAt": "2026-05-14T10:30:00Z",
  "items": [
    {
      "offer": {
        "id": "019ad428-e9cd-7982-a6fa-0ec0eebce25d"
      },
      "product": {
        "id": "019ad428-e9cd-7982-a6fa-0ec0eebce25d",
        "name": "name",
        "userGuide": null,
        "attributes": {},
        "isService": false,
        "categoryId": "019ad428-e9cd-7982-a6fa-0ec0eebce25d"
      },
      "quantity": 0,
      "externalData": [
        "string"
      ],
      "error": "string"
    }
  ],
  "paymentExpiresAt": "2026-05-14T10:30:00Z"
}

GET/api/orders/{order_id}

Get Order

Детальная информация о заказе: статус, payload (коды активации, инструкции), история событий, ссылка на чек.

Параметры

Имя	Где	Тип	Обяз.
`order_id`	path	string (uuid)	да
`x-language`	header	Language \| null	нет

cURL

curl -X GET \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-language: <x-language>" \
  https://api.marix.cc/api/orders/:order_id

Ответ 200 OrderOut

{
  "id": "019ad428-e9cd-7982-a6fa-0ec0eebce25d",
  "price": "price",
  "isMock": false,
  "status": "active",
  "cancelReason": "payment_failure",
  "createdAt": "2026-05-14T10:30:00Z",
  "items": [
    {
      "offer": {
        "id": "019ad428-e9cd-7982-a6fa-0ec0eebce25d"
      },
      "product": {
        "id": "019ad428-e9cd-7982-a6fa-0ec0eebce25d",
        "name": "name",
        "userGuide": null,
        "attributes": {},
        "isService": false,
        "categoryId": "019ad428-e9cd-7982-a6fa-0ec0eebce25d"
      },
      "quantity": 0,
      "externalData": [
        "string"
      ],
      "error": "string"
    }
  ],
  "paymentExpiresAt": "2026-05-14T10:30:00Z"
}

POST/api/orders/{order_id}/cancel

Cancel Order

Отмена заказа до момента фулфилмента. После выдачи товара отмена невозможна — потребуется оформление возврата.

Параметры

Имя	Где	Тип	Обяз.
`order_id`	path	string (uuid)	да
`x-language`	header	Language \| null	нет

cURL

curl -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-language: <x-language>" \
  https://api.marix.cc/api/orders/:order_id/cancel

Ответ 200 OrderOut

{
  "id": "019ad428-e9cd-7982-a6fa-0ec0eebce25d",
  "price": "price",
  "isMock": false,
  "status": "active",
  "cancelReason": "payment_failure",
  "createdAt": "2026-05-14T10:30:00Z",
  "items": [
    {
      "offer": {
        "id": "019ad428-e9cd-7982-a6fa-0ec0eebce25d"
      },
      "product": {
        "id": "019ad428-e9cd-7982-a6fa-0ec0eebce25d",
        "name": "name",
        "userGuide": null,
        "attributes": {},
        "isService": false,
        "categoryId": "019ad428-e9cd-7982-a6fa-0ec0eebce25d"
      },
      "quantity": 0,
      "externalData": [
        "string"
      ],
      "error": "string"
    }
  ],
  "paymentExpiresAt": "2026-05-14T10:30:00Z"
}

POST/api/orders/{order_id}/mark-paid

Mark Order Paid

Сервисный эндпоинт для ручной пометки заказа как оплаченного. Используется только во внутренних интеграциях при сверке с банковской выпиской.

Параметры

Имя	Где	Тип	Обяз.
`order_id`	path	string (uuid)	да
`x-language`	header	Language \| null	нет

cURL

curl -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-language: <x-language>" \
  https://api.marix.cc/api/orders/:order_id/mark-paid

POST/api/orders/{order_id}/pay

Create New Order Payment

Запуск повторной оплаты ранее созданного, но неоплаченного заказа. Возвращает свежую ссылку на платёжную страницу — полезно, если первая попытка провалилась.

Параметры

Имя	Где	Тип	Обяз.
`order_id`	path	string (uuid)	да
`x-language`	header	Language \| null	нет

Тело запроса OrderPaymentIn

cURL

curl -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-language: <x-language>" \
  -H "Content-Type: application/json" \
  https://api.marix.cc/api/orders/:order_id/pay \
  -d '{
  "paymentProvider": "yookassa",
  "paymentMethodType": "bank_card",
  "paymentReturnUrl": "https://marix.cc"
}'

Ответ 200 OrderPaymentOut

{
  "id": "id",
  "confirmationToken": "string",
  "confirmationUrl": "string",
  "returnUrl": "string"
}

Платёжные методы

3 эндпоинтов

GET/api/payment-methods/

List Payment Methods

Список сохранённых способов оплаты пользователя: карты, СБП-привязки, кошельки. Используйте для one-click checkout без повторного ввода данных карты.

Параметры

Имя	Где	Тип	Обяз.
`limit`	query	integer	нет
`offset`	query	integer	нет
`x-language`	header	Language \| null	нет

cURL

curl -X GET \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-language: <x-language>" \
  https://api.marix.cc/api/payment-methods/?limit=<limit?>&offset=<offset?>

Ответ 200 OffsetPagination_PaymentMethodOut_

{
  "items": [
    {
      "id": "019ad428-e9cd-7982-a6fa-0ec0eebce25d",
      "provider": "yookassa",
      "type": "bank_card",
      "title": "string"
    }
  ],
  "limit": 0,
  "offset": 0,
  "total": 0
}

POST/api/payment-methods/

Add Payment Method

Добавление нового способа оплаты. Карта токенизируется на стороне платёжного шлюза — мы храним только маскированный pan и токен, полные реквизиты до нас не доходят.

Параметры

Имя	Где	Тип	Обяз.
`x-language`	header	Language \| null	нет

Тело запроса PaymentMethodAddIn

cURL

curl -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-language: <x-language>" \
  -H "Content-Type: application/json" \
  https://api.marix.cc/api/payment-methods/ \
  -d '{
  "amount": 0,
  "returnUrl": "https://marix.cc"
}'

Ответ 200 PaymentMethodAddOut

{
  "paymentId": "paymentid",
  "confirmationToken": "string",
  "confirmationUrl": "string",
  "returnUrl": "string"
}

DELETE/api/payment-methods/{payment_method_id}

Delete Payment Method

Удаление сохранённого способа оплаты. Действие выполняется немедленно и необратимо — отменить нельзя.

Параметры

Имя	Где	Тип	Обяз.
`payment_method_id`	path	string (uuid)	да
`x-language`	header	Language \| null	нет

cURL

curl -X DELETE \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-language: <x-language>" \
  https://api.marix.cc/api/payment-methods/:payment_method_id

TON / Stars

2 эндпоинтов

GET/api/ton/ticker

Get Ton Ticker

Текущие курсы TON/USD/RUB и эталонная стоимость 1 Telegram Star. Обновляется каждые 30 секунд — используйте перед расчётом стоимости заказа в Stars.

Параметры

Имя	Где	Тип	Обяз.
`x-language`	header	Language \| null	нет

cURL

curl -X GET \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-language: <x-language>" \
  https://api.marix.cc/api/ton/ticker

POST/api/ton/buy-stars

Buy Ton Stars

Покупка Telegram Stars за TON. Возвращает реквизиты TON-адреса для перевода и tracking-id для последующего опроса статуса фулфилмента.

Параметры

Имя	Где	Тип	Обяз.
`x-language`	header	Language \| null	нет

Тело запроса BuyStarsIn

cURL

curl -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-language: <x-language>" \
  -H "Content-Type: application/json" \
  https://api.marix.cc/api/ton/buy-stars \
  -d '{
  "username": "username",
  "amount": 0
}'

Ответ 200 BuyStarsOut

{
  "success": false,
  "txHash": "string",
  "error": "string"
}

Аккаунт

1 эндпоинт

POST/api/accounts/telegram-newsletter

Send Telegram Newsletter

Подписка пользователя на Telegram-рассылку. Запускает отправку сообщения через нашего бота с подтверждением — пользователь жмёт «Старт» и получает уведомления о статусах заказов и промо-офферах.

Параметры

Имя	Где	Тип	Обяз.
`x-language`	header	Language \| null	нет

cURL

curl -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-language: <x-language>" \
  -H "Content-Type: multipart/form-data" \
  https://api.marix.cc/api/accounts/telegram-newsletter \
  -d '{
  "images": [
    "string"
  ],
  "text": "text",
  "telegramIds": [
    0
  ],
  "parseMode": "MarkdownV2",
  "inlineButtonTexts": [
    "string"
  ],
  "inlineButtonUrls": [
    "https://marix.cc"
  ]
}'

Ответ 202 TelegramNewsletterOut

{
  "total": 0,
  "sent": 0,
  "failed": 0,
  "failedTelegramIds": [
    0
  ],
  "imageFileIds": [
    "string"
  ]
}

Партнёрские интеграции

2 сценария

Как мы интегрируемся с партнёрами

Когда мы подключаем нового партнёра, оплата остаётся на его стороне — клиент платит партнёру, а мы отвечаем только за фулфилмент цифрового товара. Партнёр шлёт нам HTTP-нотификацию с идентификатором продукта и заказом, мы возвращаем товар или отправляем его сами на почту клиента, а затем подтверждаем партнёру, что заказ выполнен.

Под каждого партнёра выделяется индивидуальный slug в URL, общий signing-secret для проверки подписи запроса и согласованный whitelist productId. Ниже — два типовых сценария интеграции; конкретные URL и расширенная спецификация выдаются по запросу.

Клиент оплачивает заказ у партнёра
Партнёр шлёт нам POST с productId и данными заказа
Мы фулфилим товар: либо сразу в ответе, либо отправкой клиенту по email
Партнёр получает ответ «готово» и закрывает у себя заказ

POST/api/orders/webhooks/{partner}/notification

Сценарий 1 — синхронная выдача в ответе

Партнёр шлёт нам нотификацию о новом оплаченном заказе с указанием productId. Мы выдаём товар прямо в HTTP-ответе — код активации, ссылка или payload. Партнёр получает товар внутри своего бэкенда и сам передаёт его покупателю. Подходит, когда у партнёра уже есть свой механизм доставки клиенту.

Запрос

POST https://api.marix.cc/api/orders/webhooks/{partner}/notification
X-Signature: HMAC-SHA256(body, secret)
X-Event-Id: 019ad428-e9cd-7982-a6fa-0ec0eebce25d
Content-Type: application/json

{
  "event": "order.paid",
  "externalOrderId": "PARTNER-12345",
  "productId": "019dbf72-70af-7bd1-b60e-a35d4dbba588",
  "qty": 1,
  "amount": 4990,
  "currency": "RUB"
}

Ответ 200 payload в теле

{
  "status": "fulfilled",
  "orderId": "019dc625-6cc8-7d81-a15c-da225e61b1e0",
  "externalOrderId": "PARTNER-12345",
  "payload": {
    "type": "code",
    "value": "ABCD-EFGH-IJKL-MNOP"
  },
  "fulfilledAt": "2026-05-14T10:30:00Z"
}

Когда использовать

У партнёра есть собственный канал доставки клиенту (письмо, личный кабинет, чат-бот)
Нужен мгновенный фулфилмент в одном HTTP-цикле — синхронные платежи и кассы
Партнёр хочет показать товар в своём интерфейсе без редиректа на наш сайт

POST/api/orders/webhooks/{partner}/notification

Сценарий 2 — асинхронная выдача на email клиента

Партнёр присылает нам productId вместе с customerEmail покупателя. Мы сами формируем письмо с товаром (код активации, инструкция, ссылка на скачивание) и отправляем его клиенту. После успешной отправки уведомляем партнёра, что заказ выполнен. Подходит, когда у партнёра нет своего фулфилмента и он хочет переложить выдачу полностью на нашу сторону.

Запрос

POST https://api.marix.cc/api/orders/webhooks/{partner}/notification
X-Signature: HMAC-SHA256(body, secret)
X-Event-Id: 019ad428-e9cd-7982-a6fa-0ec0eebce25d
Content-Type: application/json

{
  "event": "order.paid",
  "externalOrderId": "PARTNER-67890",
  "productId": "019dbf72-70af-7bd1-b60e-a35d4dbba588",
  "qty": 1,
  "amount": 4990,
  "currency": "RUB",
  "deliveryMode": "email",
  "customerEmail": "buyer@example.com",
  "callbackUrl": "https://partner.example.com/orders/PARTNER-67890/callback"
}

Немедленный ответ 202 принято в обработку

{
  "status": "accepted",
  "orderId": "019dc625-6cc8-7d81-a15c-da225e61b1e0",
  "externalOrderId": "PARTNER-67890",
  "estimatedDeliverySeconds": 30
}

Callback партнёру после доставки клиенту POST на callbackUrl

POST https://partner.example.com/orders/PARTNER-67890/callback
X-Signature: HMAC-SHA256(body, secret)
Content-Type: application/json

{
  "status": "fulfilled",
  "orderId": "019dc625-6cc8-7d81-a15c-da225e61b1e0",
  "externalOrderId": "PARTNER-67890",
  "deliveredTo": "buyer@example.com",
  "deliveryMethod": "email",
  "fulfilledAt": "2026-05-14T10:30:25Z"
}

Когда использовать

У партнёра нет своей системы доставки цифровых товаров клиенту
Партнёр продаёт через формы, лендинги, чаты — где есть только email клиента
Нужна согласованная брендированная коммуникация: письма уходят от нашего домена и с нашим оформлением
Допустима асинхронность — между оплатой и доставкой могут пройти секунды или минуты

Готовы интегрироваться? Напишите @vany661 — подберём подходящий сценарий, выдадим выделенный URL и signing-secret, поможем настроить тестовые заказы.

Digital Marketplace

Быстрый старт

Получите API-ключ

Передавайте токен заголовком

Поехали

Параметры

Тело запроса LoginIn

cURL

Параметры

cURL

Параметры

cURL

Параметры

cURL

Ответ 200 UserOut

Параметры

cURL

Ответ 200 UserBalanceOut[]

Параметры

Тело запроса RegisterIn

cURL

Ответ 202 MessageOut

Параметры

cURL

Параметры

Тело запроса SsoTokenLoginIn

cURL

Параметры

cURL

Параметры

cURL

Ответ 200 CategoryOut

Параметры

cURL

Ответ 200 CategoryRecentOptionOut[]

Параметры

cURL

Ответ 200 OffsetPagination_ProductOut_

Параметры

cURL

Ответ 200 ProductOut[]

Параметры

cURL

Ответ 200 ProductOut

Параметры

cURL

Ответ 200 OffsetPagination_OrderSummaryOut_

Параметры

Тело запроса OrderCreateIn

cURL

Ответ 200 OrderOut

Параметры

Тело запроса OrderRedeemCouponIn

cURL

Ответ 200 OrderOut

Параметры

cURL

Ответ 200 OrderOut

Параметры

cURL

Ответ 200 OrderOut

Параметры

cURL

Параметры

Тело запроса OrderPaymentIn

cURL

Ответ 200 OrderPaymentOut

Параметры

cURL

Ответ 200 OffsetPagination_PaymentMethodOut_

Параметры

Тело запроса PaymentMethodAddIn

cURL

Ответ 200 PaymentMethodAddOut

Параметры

cURL

Параметры

cURL

Параметры

Тело запроса BuyStarsIn