Содержание
Используя кастомный мерчант обработки входящих платежей, можно подключить неограниченное количество собственных мерчантов для различных валют, перенаправляя пользователя на URL-адрес указанного хоста для оплаты заявки на обмен.
Визуально форма оплаты через кастомный мерчант ничем не отличается от форм встроенных в скрипт мерчантов.
Для настройки кастомного мерчанта перейдите в раздел "Настройки приложения" — "Настройка кастомного мерчанта". Вы можете указать секретный ключ, который будет использован для формирования цифровой подписи формы.
Пример запроса отправляемого формой оплаты:
curl -X POST 'https://yourhost.com' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'amount=15000.00' \
--data-urlencode 'currency_code=UAH' \
--data-urlencode 'currency=CARDUAH' \
--data-urlencode 'order_id=5cd36708f57f8801ad466a43d2175758' \
--data-urlencode 'sign=e494b3de8cdeaf8a55fb2175095468896049b7b563897bc3dade761523f35277'
Параметры запроса:
| Параметр | Описание |
|---|---|
| amount | Сумма платежа |
| currency_code | Код валюты |
| currency | Строка идентификатор валюты |
| order_id | Токен заявки на обмен |
| sign | Цифровая подпись |
Алгоритм формирования цифровой подписи:
SHA256(amount:currency_code:currency:order_id:SECRET_KEY)
После обработки платежа на стороне хоста, необходимо отправить оповещение в виде POST-запроса на URL-адрес обменника "/merchant-process/custom", что бы изменить статус заявки на "Оплачена".
Пример запроса отправляемого хостом:
curl -X POST 'https://demo.exchanger-cms.com/merchant-process/custom' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'amount=15000.00' \
--data-urlencode 'currency_code=UAH' \
--data-urlencode 'currency=CARDUAH' \
--data-urlencode 'order_id=5cd36708f57f8801ad466a43d2175758' \
--data-urlencode 'txn=bill_1601622066' \
--data-urlencode 'sign=2d12bd8be66d1814b6d4809870d07d2e7fd9709888500f5c7ec0132dbdfc5ac4'
Параметры запроса:
| Параметр | Описание |
|---|---|
| amount | Сумма платежа |
| currency_code | Код валюты |
| currency | Строка идентификатор валюты |
| order_id | Токен заявки на обмен |
| txn | Номер транзакции об оплате |
| sign | Цифровая подпись |
Алгоритм формирования цифровой подписи:
SHA256(amount:currency_code:currency:order_id:txn:SECRET_KEY)