Содержание
Используя кастомный мерчант обработки входящих платежей, можно подключить неограниченное количество собственных мерчантов для различных валют, перенаправляя пользователя на 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)