В inSales есть возможность сделать интеграцию с платежной системой, создав "прокси" из формата передачи данных inSales в формат платежной системы. После создания заказа в браузере пользователя делаем post-запрос на URL из настроек, передавая в форме все необходимые данные о заказе. В ответ ожидаем редирект пользователя назад или бэкенд-запрос о результатах платежа. Также есть возможность сделать оплату прямо в магазине через js-виджет.
url - адрес внешнего сервиса, куда будет отправлен покупатель;
send_order - передавать ли order_json с детальной информацией о заказе;
convert_currency - использовать ли конвертацию в валюту отличную от валюты сайта, нужно задать iso code валюты и валюта должна быть добавлена в магазине (чтобы было понятно по какому курсу делать конвертацию);
wigdet_mode - оплата происходит прямо на сайте магазина через js-виджет;
widget_html_code - код виджета, может содержать html и javascript.
Отправка post-запроса в платежную систему
На последнем шаге оформления заказа покупателем система inSales отправляет на внешний URL (задается в настройках внешнего способа оплаты в inSales) POST-запросом следующие параметры:
shop_id - идентификатор магазина в вашей системе;
amount - сумма;
transaction_id - id транзакции;
key - ключ заказа;
description - описание заказа;
order_id - id заказа;
phone - телефон клиента;
email - email клиента;
order_json - полная информация по заказу в json-формате (если стоит флаг send_order);
original_currency - iso code основной валюты сайта (если стоит флаг convert_currency);
convert_currency - iso code валюты, в которую выполнена конвертация (если стоит флаг convert_currency);
conversion_rate - курс пересчета;
original_amount - стоимость заказа в основной валюте сайта (если стоит флаг convert_currency);
signature - подпись. Формируется как MD5 от "shop_id;amount;transaction_id;key;description;order_id;phone;email;original_currency;convert_currency;original_amount;conversion_rate;order_json;password"
После обработки платежа внешний сервис возвращает на success_url или fail_url c параметрами.
В случае когда есть задержа между подтверждением оплаты и редиректом пользователя назад или есть соображения безопасности, то можно передать данные по платежу запросом с сервера.
amount - сумма платежа. Например, "87.10", или "1200.00".
key - ключ идентификации заказа. Изначально был отправлен inSales.
transaction_id - id транзакции. Изначально был отправлен inSales.
signature - подпись. Формируется как MD5 от "shop_id;amount;transaction_id;key;paid;password".
shop_id - идентификатор магазина.
Если все хорошо, inSales проверяет: подпись, сумму, параметр paid и shop_id. Дальше помечает заказ как успешный. В ответ возвращает json:
'status' → 'ok' в случае подтверждения;
'status' → 'error', 'errors' → одну или несколько ошибок из списка:
'transaction not found'
'data is empty'
'data is not a hash'
'signature is not valid'
'paid params is not valid'
'shop id is not valid'
'amount is not valid'
Конвертация суммы заказа при использовании поля convert_currency
Если для способа оплаты указана валюта конвертации, то при переходе в платежную систему передается сумма заказа (amount), уже сконвертированная в указанную валюту, и справочно передаются три дополнительных поля - original_currency, convert_currency и original_amount.
Важно: если передается order_json или при запросе заказа по API через /admin/orders/ID.json, то все суммы будут в оригинальной валюте сайта и конвертация не произойдет.
Оплата через виджет на сайте
1. Если для способа оплата включен widget_mode, то после создания заказа у inSales идет редирект на страницу вида /payments/external/16173/payment_page?key=0477bd091e1e2047790e32b3a42db7a5 .
2. В момент запроса этой страницы inSales отправляет запрос на внешний урл из настроек способа оплаты в json-формате передавая все данные формы, как и при редиректе в обычной форме (shop_id, amount, transaction_id, … signature ).
3. В ответе inSales ожидает 200-й код и json вида { widget_payment_data: … } .
4. Содержимое ключа widget_payment_data подставляется в js-переменную на странице: var widget_payment_data = '{}';
5. Также на странице подставляется html-код из настроек способа оплаты (поле widget_html_code).
6. Для подтверждения способа оплаты никаких новых урлов нет, ожидаем такие же запросы, как и при обычной внешней оплате.
Оценки: 2
28.04.2025 12:20
Комментарий
алгоритм хеширования детально не расписан, при разработке постоянно прихоидтся методом черного ящика разбираться что не так с подписью
Ответ разработчика:
Здравствуйте, спасибо за обратную связь, взяли информацию на проработку.
13.02.2025 08:34
Комментарий
Статья возможно и полезна, но для обычного человека это пустая трата времени, если он только не программист в пятом поколении
Ответ разработчика:
Здравствуйте. Спасибо за обратную связь! Так как само подключение внешнего способа подразумевает реализацию через API, описание больше подходит для разработчиков и расположено в разделе документации по разработке. При необходимости можно воспользоваться услугами сертифицированных партнеров inSales или услугами стороннего разработчика. Также доступна инструкция с описанием полей внешнего способа доставки, но для работоспособности способа все равно необходима доработка по API.
