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.
В оповещение о платеже, которое отправляется на Result URL, добавляются статусы по запрошенным операциям, хеш уведомлений при этом не изменяется.
При выставлении счёта надо обязательно передать дополнительные параметры для использования карты в цепочке рекуррентных платежей.
В случае передачи recurringType формирование хеша происходит по схеме:
Code Block | ||||
---|---|---|---|---|
| ||||
eshopId::orderId::serviceName::recipientAmount::recipientCurrency::recurringType::secretKey |
Имя параметра
Обязательный
Описание
recurringType
Нет
IntellectMoney предлагает функционал для управления подписками, а также проведение платежей без использования данных банковской карты клиента.
Перед началом работы с рекуррентными платежами, ознакомьтесь с инструкцией по подготовке к работе с операциями по расписанию.
Порядок работы
- Привязка карты покупателя к счету.
- Создание операций по расписанию.
- Редактирование операций по расписанию.
- Отображений операций по расписанию.
- Деактивация операций по расписанию.
Бизнес-процесс
1. Привязка карты
- Покупатель на сайте магазина выбирает товар или услугу и заполняет платежную форму, указывая, хочет ли привязать свою карту.
- Магазин отправляет запрос на оплату в IntellectMoney.
- После подтверждения данных покупателем, IntellectMoney перенаправляет на страницу оплаты и уведомляет магазин по "Result URL" о создании счета.
- Покупатель оплачивает счет банковской картой, и IntellectMoney переводит покупателя на страницу успешной оплаты по "Success URL", параллельно отправляет уведомление на "Result URL" о завершении оплаты. В уведомлении на "Result URL" будет указан параметр "recurringState = Activated", означающий, что карта привязана успешно, подробнее в описание уведомлений от системы IntellectMoney при работе с операциями по расписанию.
Пример создания счета для работы с операциями по расписанию.
2. Создание операций
Доступно после активации карты (оплата СКО созданного в пт. 1).
- Покупателю на сайте магазина предоставляется возможность создать и настроить операцию по расписанию: это может быть страница личного кабинета или страница, где пользователь точно идентифицирован. Здесь покупатель может увидеть активные подписки и управлять ими. Если доступ к странице был осуществлён до подтверждения оплаты, статус операции будет отображаться как "Выполняется", после получения на "Result URL" уведомления, статус операции изменится в соответствии со статусом "recurringState". Как только платёж подтверждён, статус обновляется в соответствии с результатом "Успешно" или "Ошибка" (в последнем случае рекомендуется обратиться в поддержку по адресу ts@intellectmoney.ru).
- Покупатель выбирает опцию создать операцию по расписанию и заполняет все нужные поля, например: сумма списания с привязанной карты, дата окончания, дата регулярного списания денежных средств, после чего нажимает подтвердить.
- Магазин отправляет запрос в IntellectMoney на создание операции по расписанию.
Пример создания операций по расписанию.
3. Редактирование операций
Аналогично созданию, с единственной разницей, дополнительно в запросе передается параметр Operation, который является идентификатором операции CronOperationId, полученный в результате создания операции по расписанию.
Пример редактирования операций по расписанию.
4. Отображение операций
Для просмотра операций по расписанию необходимо отправить запрос в IntellectMoney.
Пример получения операций по расписанию.
5. Деактивация операций
Для отключения всех операций по расписанию и запланированных списаний по исходному счету необходимо отправить запрос в IntellectMoney.
Пример деактивации операций по расписанию.
Требования МПС
- По рекуррентным платежам возможно четыре не успешные попытки в течение 16-календарных дней, при получении отказа с кодом:
- 05 - авторизация отклонена, оплату не проводить.
- 51 - недостаточно средств на счёте.
- 61 - сумма авторизации превысила расходный лимит по карте.
65 - превышен лимит расходных операций по счёту.
Warning Если в течение этого срока не был получен положительный код авторизации, то дальнейшие попытки проведения платежа будут прекращены. Если отказ в авторизации карты произошел с кодом:
- 14 - недействительный номер карты.
- 54 - истёк срок действия карты, изъятию не подлежит.
57 - данный тип транзакции не предусмотрен для предъявленной карты.
Warning Следующая попытка будет запрещена и рекуррентный платеж отменен. - В случае получения других ошибок, обработка будет происходить в соответствии указанным параметрам "RetryOnFailPlan", "RetryOnFailCount", которые были указаны при создание или редактирование операций.
Онлайн-касса
Чеки для рекуррентных платежей формируются автоматически с одной позицией на сумму счёта, установка НДС выполняется согласно настройкам онлайн-кассы магазина в личном кабинете, наименование позиции устанавливается из описания счёта или из параметра "ParamsJson".
Тип операции рекарринга, возможные значения:
Номер СКО, которым была инициирована цепочка платежей (счет, по которому был передан recurringType = Activate)
Является обязательным если не передан recurringType = Pay
Для создания операции по расписанию, счёт должен быть оплачем методом "Банковская карта", это можно сделать разными способами:
- Из личного кабинета IntellectMoney в разделе "Список счетов".
- Воспользоваться Merchant API
- Перейти по ссылке https://merchant.intellectmoney.ru/ru/index.php?invoiceId=номер_счёта&eshopId=номер_магазина
В оповещении, отправляемом на Result URL, нам Важны два параметра:
reccurringState - отображает состояния операции по расписанию
Имя параметра
Описание
Activated - Активирован, можно создавать операцию по расписанию
Deactivated - Активация отменена
Payed - Оплата завершена, операцию по расписанию выполнена
Error - Ошибка обработки операции, операция обработана не будет
Multiexcerpt include | ||||
---|---|---|---|---|
|
Multiexcerpt include | ||||
---|---|---|---|---|
|
GetScheduledOperation() — получение списка операций по расписанию
Multiexcerpt include | ||||
---|---|---|---|---|
|
Multiexcerpt include | ||||
---|---|---|---|---|
|
Типы данных
Multiexcerpt include | ||||
---|---|---|---|---|
|
Multiexcerpt include | ||||
---|---|---|---|---|
|
Multiexcerpt include
Table of Contents | ||
---|---|---|
|