Техническая поддержка

Page tree

Versions Compared

Old Version 25

changes.mady.by.user Unknown User (s.zhukov)

Saved on

compared with

New Version Current

changes.mady.by.user IntellectMoney

Saved on

Key

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

Описание

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

Схема работы

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

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

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

  4. Создание операции по расписанию.

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

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

В случае передачи 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

AnchorinvoicePayinvoicePayОплата счёта

Для создания операции по расписанию, счёт должен быть оплачем методом "Банковская карта", это можно сделать разными способами:

  1. Из личного кабинета IntellectMoney в разделе "Список счетов".
  2. Воспользоваться Merchant API
  3. Перейти по ссылке https://merchant.intellectmoney.ru/ru/index.php?invoiceId=номер_счёта&eshopId=номер_магазина
AnchorresultUrlresultUrlОповещение на Result URL

В оповещении, отправляемом на Result URL, нам Важны два параметра:

reccurringState - отображает состояния операции по расписанию

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

Описание

recurringState

Activated - Активирован, можно создавать операцию по расписанию

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

Payed - Оплата завершена, операцию по расписанию выполнена

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

  • paymentId - номер счёта к оплате в системе IntellectMoney, начинается на "3", десятизначный.
    • AnchorgetUserTokengetUserTokengetUserToken() — Аутентификация клиента API

    Multiexcerpt include
    MultiExcerptNamegetUserToken
    PageWithExcerptДокументация Personal API

    AnchorsetScheduledOperationsetScheduledOperationSetScheduledOperation() — Создание операций по расписанию
    Multiexcerpt include
    MultiExcerptNamesetScheduledOperation
    PageWithExcerptДокументация Personal API

    GetScheduledOperation() — получение списка операций по расписанию

    Multiexcerpt include
    MultiExcerptNamegetScheduledOperation
    PageWithExcerptДокументация Personal API

    AnchoradditionalInfoadditionalInfoДополнительная информация

    Multiexcerpt include
    MultiExcerptNameadditionalInfo
    PageWithExcerptДокументация Personal API

    Типы данных

    Anchor<SetScheduledOperationData><SetScheduledOperationData><SetScheduledOperationData>
    Multiexcerpt include
    MultiExcerptNamesetScheduledOperationData
    PageWithExcerptДокументация Personal API
    Anchor<GetScheduledOperationData><GetScheduledOperationData><GetScheduledOperationData>
    Multiexcerpt include
    MultiExcerptNamegetScheduledOperationData
    PageWithExcerptДокументация Personal API
    Anchor<ScheduledOperationData><ScheduledOperationData><ScheduledOperationData>

    Multiexcerpt includeMultiExcerptNameScheduledOperationDataPageWithExcerptДокументация Personal API

    Table of Contents
    maxLevel2