Описание
Система дает возможность регистрировать/отменять подписку и проводить платежи без участия карточных данных клиента. Данный функционал применим для магазинов, работающих по протоколу IntellectMoney, в настройках магазина должна быть включена настройка "Требовать HASH".
Схема работы
Выставляем счёт. Счёт можно выставить как через Merchant API так и с помощью HTML формы.
Оплачиваем, выставленный в пункте 1, счёт банковской картой. Оплатить можно на странице оплаты merchant.intellectmoney.ru или через Merchant API.
В оповещение о платеже, которое отправляется на Result URL, добавляются статусы по запрошенным операциям, хеш уведомлений при этом не изменяется.
Создание операции по расписанию.
Anchor |
---|
| createInvoice2 |
---|
| createInvoice2 |
---|
|
Выставление счёта
При выставлении счёта надо обязательно передать дополнительные параметры для использования карты в цепочке рекуррентных платежей.
В случае передачи recurringType формирование хеша происходит по схеме:
Code Block |
---|
language | xml |
---|
title | Формирование hash- подписи |
---|
|
eshopId::orderId::serviceName::recipientAmount::recipientCurrency::recurringType::secretKey |
Имя параметра | Обязательный | Описание |
---|
recurringType | Нет | Тип операции рекарринга, возможные значения: Название | Назначение | Описание |
---|
Activate | Для регистрации цепочки | Карта регистрируется в цепочке платежей, дальше для всех операций с этой картой нужно передавать оплаченный счет(Номер Счёта К Оплате) в поле recurringSourceInvoiceId, остальные операции над выставленными счетами проводятся системой в автоматическом режиме без участия пользователя | Deactivate | Для отмены регистрации цепочки |
| Pay | Для оплаты |
|
|
recurringInfo | Нет | Информация для пользователя, которая показывается в процессе оплаты, перед вводом реквизитов банковской карты |
recurringSourceInvoiceId | Нет | Номер СКО, которым была инициирована цепочка платежей (счет, по которому был передан recurringType = Activate) Является обязательным если не передан recurringType = Pay |
Оплата счёта
Для создания операции по расписанию, счёт должен быть оплачем методом "Банковская карта", это можно сделать разными способами:
- Из личного кабинета IntellectMoney в разделе "Список счетов".
- Воспользоваться Merchant API
- Перейти по ссылке https://merchant.intellectmoney.ru/ru/index.php?invoiceId=номер_счёта&eshopId=номер_магазина
Оповещение на Result URL
В оповещении, отправляемом на Result URL, нам Важны два параметра:
reccurringState - отображает состояния операции по расписанию
Имя параметра | Описание |
---|
recurringState | Activated - Активирован, можно создавать операцию по расписанию Deactivated - Активация отменена Payed - Оплата завершена, операцию по расписанию выполнена Error - Ошибка обработки операции, операция обработана не будет |
- paymentId - номер счёта к оплате в системе IntellectMoney, начинается на "3", десятизначный.
getUserToken() — Аутентификация клиента API
Multiexcerpt include |
---|
MultiExcerptName | getUserToken |
---|
PageWithExcerpt | Документация Personal API |
---|
|
Anchor |
---|
| setScheduledOperation |
---|
| setScheduledOperation |
---|
|
SetScheduledOperation() — Создание операций по расписанию
Multiexcerpt include |
---|
MultiExcerptName | setScheduledOperation |
---|
PageWithExcerpt | Документация Personal API |
---|
|
GetScheduledOperation() — получение списка операций по расписанию
Multiexcerpt include |
---|
MultiExcerptName | getScheduledOperation |
---|
PageWithExcerpt | Документация Personal API |
---|
|
Anchor |
---|
| additionalInfo |
---|
| additionalInfo |
---|
|
Дополнительная информация
Multiexcerpt include |
---|
MultiExcerptName | additionalInfo |
---|
PageWithExcerpt | Документация Personal API |
---|
|
Типы данных
Anchor |
---|
| <SetScheduledOperationData> |
---|
| <SetScheduledOperationData> |
---|
|
<SetScheduledOperationData>
Multiexcerpt include |
---|
MultiExcerptName | setScheduledOperationData |
---|
PageWithExcerpt | Документация Personal API |
---|
|
Anchor |
---|
| <GetScheduledOperationData> |
---|
| <GetScheduledOperationData> |
---|
|
<GetScheduledOperationData>
Multiexcerpt include |
---|
MultiExcerptName | getScheduledOperationData |
---|
PageWithExcerpt | Документация Personal API |
---|
|
Anchor |
---|
| <ScheduledOperationData> |
---|
| <ScheduledOperationData> |
---|
|
<ScheduledOperationData>
Multiexcerpt include |
---|
MultiExcerptName | ScheduledOperationData |
---|
PageWithExcerpt | Документация Personal API |
---|
|