База знаний

MoneclePay позволяет принимать платежи через платформу Monecle и получать уведомления об успешных оплатах на указанный вами адрес. Для организации приёма платежей в первую очередь необходимо зарегистрироваться в сервисе Monecle как продавец и получить ваш идентификатор и секретный ключ на странице интеграции. После выполнения этих действий можно приступать к реализации запроса на оформление платежа.

Запрос на оформление платежа

Оформление платежа происходит отправкой POST-запроса с формой, содержащей данные, по адресу https://monecle.com/payment. В таблице ниже приведены параметры формы:

Алгоритм формирования подписи запроса

Подпись запроса формируется на основе передаваемых параметров и секретного ключа. Чтобы сформировать подпись нужно:

1. Отсортировать список передаваемых параметров по наименованию в алфавитном порядке.
2. Объединить значения параметров в одну строку, используя разделитель ";". В результате должна получиться строка, похожая на эту: ""[email protected];John Doe;+7 999 999 99 99;https://my-site.ru/pay;external_good_id-1;https://my-site.ru/pay/fail;Item 1;99;1;https://my-site.ru/pay/success;123""
3. Получившуюся строку нужно зашифровать методом HMAC с использованием алгоритма SHA256, где в качестве ключа нужно использовать ключ, указанный в разделе интеграции. Получившееся значение и нужно передавать в качестве подписи.

Пример формирования подписи на языке PHP:
$params = [
    'buyer_email' => '[email protected]',
    'buyer_name' => 'John Doe',
    'buyer_phone' => '+7 999 999 99 99',
    'good_name' => 'Item 1',
    'good_price' => 99,
    'installment' => 1,
    'success_url' => 'https://my-site.ru/pay/success',
    'fail_url' => 'https://my-site.ru/pay/fail',
    'callback_url' => 'https://my-site.ru/pay',
    'user_id' => 123,
    'external_good_id' => 'external_good_id-1',
];
ksort($params);
$params = implode(';', $params);
$key = 'secret';
$signature = hash_hmac('sha256', $params, $key); // 68bfb4a64f54583238363d7193b472fb13e6e6bcfe5275b2d9ebc77fe5c92f77

Пример формы

<form action="https://monecle.com/payment" method="POST">
    <input type="text" name="buyer_email" value="[email protected]"><br>
    <input type="text" name="buyer_name" value="John Doe"><br>
    <input type="text" name="buyer_phone" value="+7 999 999 99 99"><br>
    <input type="text" name="good_name" value="Item 1"><br>
    <input type="text" name="good_price" value="99"><br>
    <input type="text" name="installment" value="1"><br>
    <input type="text" name="success_url" value="https://my-site.ru/pay/success"><br>
    <input type="text" name="fail_url" value="https://my-site.ru/pay/fail"><br>
    <input type="text" name="callback_url" value="https://my-site.ru/pay"><br>
    <input type="text" name="user_id" value="123"><br>
    <input type="text" name="external_good_id" value="external_good_id-1"><br>
    <input type="text" name="signature" value="68bfb4a64f54583238363d7193b472fb13e6e6bcfe5275b2d9ebc77fe5c92f77"><br>
    <input type="submit" value="Submit">
</form>

В данном примере для формирования подписи использовался ключ "secret".

Отправка уведомления

После успешной оплаты отправляется уведомление, сигнализирующее об этом. Это уведомление отправляется POST-запросом в формате JSON на адрес, указанный в поле "callback_url". Ответом на это уведомление должен быть HTTP-статус, сигнализирующий об успехе операции (первая цифра статуса должна быть равна 2). Уведомление об оплате будет посылаться до тех пор, пока не будет получен необходимый статус, но не более 10 раз. С каждой новой попыткой отправки уведомления увеличивается временной интервал. Ниже приведены все интервалы.

Уведомление содержит данные, описание которых приведено в следующей таблице: