Миграция подписок

Введение

Данный метод позволяет произвести миграцию подписок с вашего сервиса - в платежный шлюз, при условии, что вы ранее работали напрямую с ПЦ ЭК.

Т.к. при создании подписки передается идентификатор платежного инструмента bindingId, который обязательно проверяется на наличие у указанного номера телефона. Если такого bindingId нет у данного номера телефона - получите код ошибки: 00200024.

Важно!

Гарантии идемпотентности:

• Метод обеспечивает идемпотентность по полю Request-Id в течение 3 суток
• Повторные запросы с одинаковым Request-Id не приведут к созданию дублирующих подписок
• Система гарантирует обработку только уникальных запросов на основе Request-Id

Ответственность потребителя:

• Создание и поддержание бизнес-логики единичности подписки для пользователя
• Гарантия того, что в вашей системе не отправляются запросы с разными Request-Id для одной бизнес-подписки
• Использование метода получения списка подписок для проверки существующих активных подписок перед созданием новой

Важно:
При передаче разных значений Request-Id для одной подписки будут созданы дубликаты идентичных подписок.

Для проверки существующих активных подписок у абонента - можно воспользоваться методом получения списка подписок: Получение списка подписок.

Указав параметры:

• clientPhone - со значением номера телефона.
• и status=active.

Входные параметры

Заголовок запроса

Так же, передается SSL сертификат.

Тело запроса

Описание структуры paymentTool

Описание структуры ewalletBinding

Описание структуры extMobileCommerce

Описание структуры promo

Обязательность promo.period и promo.endDate полей - условно:

• Если передано durationType=quant, то обязательно поле period.
• Если передано durationType=date, то обязательно поле endDate.

Выходные параметры

Заголовок ответа

Тело ответа

Примеры

Заголовок запроса

Тело запроса

{
  "serviceId": 0,
  "extClientId": "string",
  "clientPhone": "string",
  "merchantMnemonic": "string",
  "userMnemonic": "string",
  "amount": 0,
  "currency": "string",
  "startDate": "2026-04-23T11:08:29.925Z",
  "endDate": "2026-04-23T11:08:29.925Z",
  "period": 0,
  "periodQuant": "day",
  "serviceParams": {
    "additionalProp1": "string",
    "additionalProp2": "string",
    "additionalProp3": "string"
  },
  "paymentTool": {
    "eWalletBinding": {
      "bindingId": "string"
    },
    "extMobileCommerce": {
      "phone": "string"
    }
  },
  "nextPaymentDate": "2026-04-23T11:08:29.925Z",
  "promo": {
    "amount": 0,
    "durationType": "quant",
    "period": 0,
    "endDate": "2026-04-23T11:08:29.925Z"
  },
  "trialPeriod": 0
}

{
  "serviceId": 6340,
  "clientPhone": "79685310278",
  "extClientId": "56ca5019-f8df-4baa-9406-961233799c6c",
  "serviceParams": {
    "id1": "108882256562"
  },
  "period": 1,
  "periodQuant": "day",
  "startDate": "2022-02-08T13:59:41.162Z",
  "amount": 13.4,
  "currency": "643",
  "nextPaymentDate": "2022-03-08T13:59:41.162Z",
  "promo": {
      "amount": 10.02,
      "durationType": "quant",
      "period": 4
           },
  "paymentTool": {
    "extMobileCommerce": {
      "phone": "7911223344"
    }
  }
}

Заголовок ответа

Тело ответа

{
  "id" : "3417b9ff-6906-4ba1-b741-024d7cbfd8b4",
  "resultCode" : "created"
}

Возможные коды ошибок