Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Описание

Система дает возможность регистрировать/отменять подписку и проводить платежи без участия карточных данных клиента. Данный функционал применим для магазинов, работающих по протоколу IntellectMoney, в настройках магазина должна быть включена настройка "Требовать HASH".

Схема работы

  • Выставляем счёт. Счёт можно выставить как через Merchant API так и с помощью HTML формы.

  • Оплачиваем, выставленный в пункте 1, счёт банковской картой. Оплатить можно на странице оплаты merchant.intellectmoney.ru или через Merchant API.

  • В оповещение о платеже добавляются статусы по запрошенным операциям, хеш уведомлений при этом не изменяется. 

    Имя параметра

    Описание

    recurringState

    Статус, по итогам регистрации операции в банке эквайере:

    Activated - Активирован

    Deactivated - Активация отменена

    Payed - Оплата завершена

    Error - Ошибка обработки операции, операция обработана не будет

  • Регистрация регулярной операции через документацию по Операции по расписанию

  • Выставление счёта

    При выставлении счёта надо обязательно передать дополнительные параметры для использования карты в цепочке рекуррентных платежей.

    В случае передачи recurringType формирование хеша происходит по схеме: 

    Code Block
    languagexml
    titleФормирование hash- подписи
    eshopId::orderId::serviceName::recipientAmount::recipientCurrency::recurringType::secretKey

    Имя параметра

    Обязательный

    Описание

    recurringType

    Нет

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

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

    Порядок работы

    1. Привязка карты покупателя к счету.
    2. Создание операций по расписанию.
    3. Редактирование операций по расписанию.
    4. Отображений операций по расписанию.
    5. Деактивация операций по расписанию.

    Бизнес-процесс

    1. Привязка карты

    1. Покупатель на сайте магазина выбирает товар или услугу и заполняет платежную форму, указывая, хочет ли привязать свою карту.
    2. Магазин отправляет запрос на оплату в IntellectMoney.
    3. После подтверждения данных покупателем, IntellectMoney перенаправляет на страницу оплаты и уведомляет магазин по "Result URL" о создании счета.
    4. Покупатель оплачивает счет банковской картой, и IntellectMoney переводит покупателя на страницу успешной оплаты по "Success URL", параллельно отправляет уведомление на "Result URL" о завершении оплаты. В уведомлении на "Result URL" будет указан параметр "recurringState = Activated", означающий, что карта привязана успешно, подробнее в описание уведомлений от системы IntellectMoney при работе с операциями по расписанию.

    Пример создания счета для работы с операциями по расписанию.

    2. Создание операций

    Доступно после активации карты (оплата СКО созданного в пт. 1). 

    1. Покупателю на сайте магазина предоставляется возможность создать и настроить операцию по расписанию: это может быть страница личного кабинета или страница, где пользователь точно идентифицирован. Здесь покупатель может увидеть активные подписки и управлять ими. Если доступ к странице был осуществлён до подтверждения оплаты, статус операции будет отображаться как "Выполняется", после получения на "Result URL" уведомления, статус операции изменится в соответствии со статусом "recurringState". Как только платёж подтверждён, статус обновляется в соответствии с результатом "Успешно" или "Ошибка" (в последнем случае рекомендуется обратиться в поддержку по адресу ts@intellectmoney.ru).
    2. Покупатель выбирает опцию создать операцию по расписанию и заполняет все нужные поля, например: сумма списания с привязанной карты, дата окончания, дата регулярного списания денежных средств, после чего нажимает подтвердить.
    3. Магазин отправляет запрос в IntellectMoney на создание операции по расписанию.

    Пример создания операций по расписанию.

    3. Редактирование операций

    Аналогично созданию, с единственной разницей, дополнительно в запросе передается параметр Operation, который является идентификатором операции CronOperationId, полученный в результате создания операции по расписанию. 

    Пример редактирования операций по расписанию.

    4. Отображение операций

    Для просмотра операций по расписанию необходимо отправить запрос в IntellectMoney.

    Пример получения операций по расписанию.

    5. Деактивация операций

    Для отключения всех операций по расписанию и запланированных списаний по исходному счету необходимо отправить запрос в IntellectMoney. 

    Пример деактивации операций по расписанию.

    Требования МПС

    1. По рекуррентным платежам возможно четыре не успешные попытки в течение 16-календарных дней, при получении отказа с кодом: 
      • 05 - авторизация отклонена, оплату не проводить.
      • 51 - недостаточно средств на счёте.
      • 61 - сумма авторизации превысила расходный лимит по карте.
      • 65 - превышен лимит расходных операций по счёту.

      Warning
      Если в течение этого срока не был получен положительный код авторизации, то дальнейшие попытки проведения платежа будут прекращены.


    2. Если отказ в авторизации карты произошел с кодом:

      • 14 - недействительный номер карты.
      • 54 - истёк срок действия карты, изъятию не подлежит.
      • 57 - данный тип транзакции не предусмотрен для предъявленной карты.

      Warning
      Следующая попытка будет запрещена и рекуррентный платеж отменен.


    3. В случае получения других ошибок, обработка будет происходить в соответствии указанным параметрам "RetryOnFailPlan", "RetryOnFailCount", которые были указаны при создание или редактирование операций.

    Онлайн-касса

    Чеки для рекуррентных платежей формируются автоматически с одной позицией на сумму счёта, установка НДС выполняется согласно настройкам онлайн-кассы магазина в личном кабинете, наименование позиции устанавливается из описания счёта или из параметра "ParamsJson".

    Тип операции рекарринга, возможные значения:

    НазваниеНазначениеОписаниеActivateДля регистрации цепочкиКарта регистрируется в цепочке платежей, дальше для всех операций с этой картой нужно передавать оплаченный счет в поле recurringSourceInvoiceId, остальные операции над выставленными счетами проводится системой в автоматическом режиме без участия пользователяDeactivateДля отмены регистрации цепочкиPayДля оплатыrecurringInfoНетИнформация для пользователя, которая показывается в процессе оплаты, перед вводом реквизитов банковской картыrecurringSourceInvoiceIdНет

    Номер СКО, которым была инициирована цепочка платежей (счет, по которому был передан recurringType = Activate)

    Является обязательным если не передан recurringType = Pay

    Пример на языке программирования PHP:

    Code Block
    languagephp
    themeConfluence
    titleПример выставления счета через Merchant API

    Excerpt IncludeДокументация Personal APIДокументация Personal API

    Table of Contents
    maxLevel2