В главное меню

Платежи по требованию партнера (paymentToken)


Общее описание интеграция сценария 

Активация платежного токена

  1. Партнер заполняет заявку для интеграции.
  2. MTS Pay проводит настройки service_id и авторизационного сертификата.
  3. MTS Pay передает Партнеру авторизационный сертификат и service_id для запроса на создание сессии.
  4. MTS Pay предоставляет доступ в личный кабинет с ролью "Администратор".
  5. Партнер проводит настройки на своей стороне, а также интегрируется с MTS ID (документация MTS ID). Авторизация необходима в данной интеграции.
  6. Партнер создает сессию для создания платежного токена. На этом этапе доступно 2 сценария:
    1. Сценарий создания платежного токена (привязка карты) без текущей покупки, но для проведения дальнейших оплат без участи клиента. В запросе необходимо указать параметры:
      1. параметр createPaymentToken = true (обязательно)
      2. сумма = 0 (обязательно)
      3. блок serviceParams→orderNumber  (обязательно) (так же любые другие параметры партнера, которые необходимы)
      4. другие обязательные параметры, отмеченные в документации
    2. Сценарий создания платежного токена (привязка карты) с текущей оплатой. В запросе необходимо указать параметры:
      1. параметр createPaymentToken = true (обязательно)
      2. сумма = сумме покупки
      3. блок serviceParams→orderNumber (обязательно (так же любые другие параметры партнера, которые необходимы)
      4. другие обязательные параметры, отмеченные в документации
  7. Партнер вызывает интерфейс выбора платежного инструмента для будущих оплат, выбранный на этапе интеграции.
    1. При вызове интерфейс выбора платежного инструмента требуется передать sso-token, полученный от MTS ID при авторизации
  8. Клиент оплачивает:
      1. Если оплата прошла успешно 
        1. Платежный токен активируется и партнеру отправляются нотификации (cтрогой упорядоченности в уведомлениях нет, первым может отправиться как уведомление о платеже так и уведомление о токене):
          1. "О результате платежа"
            1. MTS Pay НЕ отправляет нотификации по верификационным платежам.
          2. "О создании платежного токена"
      2. Если оплата прошла не успешно
        1. Платежный токен НЕ активируется и партнеру отправляется одна нотификация
          1. "О результате платежа"
            1. MTS Pay НЕ отправляет нотификации по верификационным платежам.
      3. Если оплаты не было
        1. Платежный токен НЕ активируется и партнеру НЕ отправляется ни одна нотификация
  9. Оплата по платежному токену доступна только в случае успешной первой оплаты (именно оплаты при создании платежного токена)

Последующие оплаты по платежному токену

  1. Партнер проводит очередную оплату по платежному токену:
    1. Если планируется оплата платежным токеном с разными параметрами в блоке serviceParams, необходимо настроить мультисервисность со стороны MTS Pay!
    2. Если оплата успешна
      1. партнеру отправляется одна нотификация
        1. "О результате платежа"
    3. Если оплата неуспешна
      1. получили ошибку
        1. влияет на блокировку платежного токена, следующая оплата возможна через сутки+1 мин
          1. партнеру отправится одна нотификация
            1. "О результате платежа"
            2.  Последующие попытки будут отбиваться ошибкой на этапе запроса на оплату
        2. влияет на отключение/блокировку платежного токена, дальнейшая оплата невозможна, требуется пересоздание платежного токен
          1. партнеру отправится 2 нотификации
            1. "О результате платежа"
            2. "Об отключении платежного токена"

Дополнительные операции:

  1. По успешным платежам партнер может проводить:
    1. отмену платежа
    2. возврат платежа