Merchant
is the fastest and most secure service to receive payments
is the fastest and most secure service to receive payments
Документация
Наша платежная платформа позволяет подключить на ваш веб-сайт прием платежей с пластиковых карт в интернете в виде готовой платежной формы по API. С нами вы можете организовать прием платежей в интернете быстро и гибко так, как это нужно именно вам. Мы создаем продукт, который удобен не только для бизнеса, но и для разработчиков.
Взаимодействие с API
Запуск процесса оплаты посредством сервиса FMFB Merchant со стороны мерчанта состоит из двух этапов:
Первый этап - запрос на получение подписи заказа который потребуется для дальнейшего шага.
Второй этап - формирование платежной ссылки и перенаправление клиента в данную ссылку.
В личном кабинете мерчанта - "Мерчант > Интеграция Магазина" - находиться информация по ключам для
взаимодействия с сервисом Onlinepay
Ниже предоставлена таблица с наименованием данных ключей.
| Имя | Описание |
|---|---|
| Client Code | Код мерчанта в системе |
| Client Api Key | Секретный ключ мерчанта |
| Root Api Key | Секретный ключ сервиса Onlinepay Merchant |
Запрос на получение подписи заказа
Данный шаг рекомендуется совершать в закрытой части (бэкэнд) приложения мерчанта. Чтобы отправить запрос на сервис Onlinepay Merchant для получения подписи заказа, сначала требуется сформировать hash, который будет отправляться в числе параметров запроса. Перечень параметров запроса отображен в нижеследующей таблице. Параметр hash это захешериваное значение по алгоритму SHA256 текстовой строки, которая составляется конкатенацией некоторых параметров. Ниже представлены параметры, которые конкатенируются.
Далее отправляем POST запрос с параметрами перечисленнемы в таблице.
| Атрибут/Параметр | Тип данных | Описание | Обяз. |
|---|---|---|---|
| client_code | String | Код мерчанта в системе | да |
| order_id | String | Идентификатор заказа | да |
| amount | Number(8, 2) | Стоимость покупки (заказа), разделитель точка | да |
| item_url | String | Ссылка на продукт | да |
| hash | String | Рассчитанный хэш | да |
При успешном запросе предоставляется ответ от сервиса Onlinepay Merchant в данном ввиде.
Перенаправление на платежный шлюз
В указанном ниже примере вместо фигурных скобок необходимо подставить параметры, указаные в таблице.
| Атрибут/Параметр | Тип данных | Описание | Обяз. |
|---|---|---|---|
| signature | String | Подпись заказа | да |
| order_id | String | Идентификатор заказа | да |
| client_code | String | Код мерчанта в системе | да |
Пример:
Результат операции
В результате, после снятия суммы с карты либо неуспешной операции снятия, инициатор получает ответ на шлюз,
который ранее был указан при регистрации мерчанта.
Параметры ответа на шлюз(Success url) при успешной операции:
Параметры ответа на шлюз(False url) при неуспешной операции: