База знаний

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;https://my-site.ru/pay/success;123"
3. Получившуюся строку нужно зашифровать методом HMAC с использованием алгоритма SHA256, где в качестве ключа нужно использовать ключ, указанный в разделе интеграции. Получившееся значение и нужно передавать в качестве подписи.

Пример формы

<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="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="6983683be6a7152d4e6cdfd9506dd69a6fd43846a9b46304af97567a5c773ebc"><br>
    <input type="submit" value="Submit">
</form>

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

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

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

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