Описание

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

Схема работы

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

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

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

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

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

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

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

eshopId::orderId::serviceName::recipientAmount::recipientCurrency::recurringType::secretKey

Оплата счёта

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

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

Оповещение на Result URL

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

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

   Имя параметра	Описание
   recurringState	Activated - Активирован, можно создавать операцию по расписанию Deactivated - Активация отменена Payed - Оплата завершена, операцию по расписанию выполнена Error - Ошибка обработки операции, операция обработана не будет

2. paymentId - номер счёта к оплате в системе IntellectMoney, начинается на "3", десятизначный.

getUserToken() — Аутентификация клиента API

The page Документация Personal API was not found  -- Please check/update the page name used in the MultiExcerpt-Include macro

SetScheduledOperation() — Создание операций по расписанию

The page Документация Personal API was not found  -- Please check/update the page name used in the MultiExcerpt-Include macro

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

Для получения списка операций по расписанию необходимо отправить GET- или POST-запрос на следующий адрес URL:
https://api.intellectmoney.ru/personal/payment/getScheduledOperation

В ответ возвращается  код операции  и возможны 3 варианта:

1. Запрос обработался моментально. Ответ типа  <Response>  будет содержать структуру  <GetScheduledOperationData>  (синхронная обработка). ( Код операции - 0 )

2. Запрос был поставлен в очередь на обработку. Ответ типа  <Response>   будет содержать идентификатор операции, по которому можно запросить результат выполнения операции (асинхронная обработка). (Код операции - 1 )

3. Ошибка обработки операции. Операция выполнена не будет. ( Код операции - 2 )

$urlMerchantApi = "https://dev.app.server:1443/usemyachkin/merchant/";
$urlGetToken = "https://api.intellectmoney.ru/personal/user/getUserToken";
$login = "Ваш логин от личного кабинета IntellectMoney"; 
$password = "Ваш пароль от личного кабинета IntellectMoney";



function curlRequest($func, $data) {
    global $urlMerchantApi;
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
    curl_setopt($ch, CURLOPT_URL, $urlMerchantApi . $func . "?" . $data);
    curl_setopt($ch, CURLOPT_HEADER, 0);
    curl_exec($ch);
    print_r($ch);
    curl_close($ch);
}
function getToken(){
    global $urlGetToken;
    global $login;
    global $password;
    $result = file_get_contents($urlGetToken."?Login=".$login."&Password=".$password);
    $xml = new SimpleXMLElement($result);
    $userToken = $xml->Result->UserToken[0];
    
    return $userToken;
}

// создаем счёт через метод createInvoice() 
$orderId = '86543189414563218';
$recipientAmount = number_format(floatval(10), 2, '.', '');
$recipientCurrency = 'TST';
$serviceName = 'test';
$eshopId = '450090';
$secretKey = '<56id786ih89';
$recurringType = "Activate";
$userName = "Payer Name";
$email = "s.zhukov@intellectmoney.ru";

$purchaseHash = md5($eshopId . "::" . $orderId . "::" . $serviceName . "::" . $recipientAmount . "::" . $recipientCurrency . "::" . $recurringType . "::" . $secretKey);
$hash = md5("$eshopId::$orderId::$serviceName::$recipientAmount::$recipientCurrency::$userName::$email::::::::::::::::$secretKey");

$data = array(
    'eshopId' => $eshopId,
    'recipientAmount' => $recipientAmount,
    'recipientCurrency' => $recipientCurrency,
    'email' => $email,
    'userName' => $userName,
    'serviceName' => $serviceName,
    'orderId' => $orderId,
    'recurringType' => $recurringType,
    'purchaseHash' => $purchaseHash,
    'hash' => $hash,
);
$queryString = http_build_query($data);
curlRequest('createInvoice', $queryString);

//Данный метод можно вызывать только когда на Result URL пришло уведомление об оплате счёта банковской картой
//С параметром recurringState равным Activated
//Создаём операцию по расписанию через метод SetScheduledOperation() {

Типы данных

<SetScheduledOperationData>

The page Документация Personal API was not found  -- Please check/update the page name used in the MultiExcerpt-Include macro

<ScheduledOperationData>