Документація
Посібник користувача
Продукти
Розробникам
Кастомний мерчант
Останнє оновлення: 03.05.2023 11:59
Принцип роботи
Використовуючи кастомний мерчант, можна самостійно генерувати реквізити, HTML-форми, посилання на оплату заявки на обмін та проводити подальшу обробку платежу.
Налаштування
Для налаштування кастомного мерчанта, перейдіть до розділу "Налаштування додатка" - "Налаштування кастомного мерчанта (API)". Вам потрібно придумати секретний ключ, який надсилатиметься в HTTP-заголовку "X-Authorization" і використовуватиметься для формування цифрового підпису.
Приклад запиту
curl -X POST 'https://ВАШ.ХОСТ' \
--header 'X-Authorization: СЕКРЕТНИЙ_КЛЮЧ' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode '0=127.0.0.1' \
--data-urlencode '1=52a840d46a0c8680234f4e3a99112e5c' \
--data-urlencode '2=1054441680' \
--data-urlencode '3=10500.43' \
--data-urlencode '4=2' \
--data-urlencode '5=UAH' \
--data-urlencode '6=CARDUAH' \
--data-urlencode '7=4000000000000010'
| Параметр | Опис |
|---|---|
| 0 | IP-адреса користувача |
| 1 | Токен заявки на обмін |
| 2 | ID мерчанта |
| 3 | Сума до оплати |
| 4 | Кількість знаків після коми валюти |
| 5 | Код валюти |
| 6 | Рядок ідентифікатор валюти |
| 7 | Платіжні реквізити користувача |
Приклад відповіді
Успішна відповідь (посилання):
{
"success": true,
"result": {
"link": "https://exchanger-cms.com"
}
}
Успішна відповідь (криптовалютна адреса):
{
"success": true,
"result": {
"address": "0x0000000000",
"tag": ""
}
}
Успішна відповідь (платіжні реквізити):
{
"success": true,
"result": {
"detail": "4000000000000000"
}
}
Успішна відповідь (HTML-форма):
{
"success": true,
"result": {
"action": "https://exchanger-cms.com",
"keys": ["key"],
"values": ["val"]
}
}
Неуспішна відповідь:
{
"success": false,
"message": "Необов'язкове повідомлення про помилку."
}
Після обробки платежу, необхідно відправити POST-запиту на URL-адресу обмінника, щоб змінити статус заявки на "Оплачено".
curl -X POST 'https://ВАШ.ДОМЕН/merchant-process/custom' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'token=52a840d46a0c8680234f4e3a99112e5c' \
--data-urlencode 'amount=10500.43' \
--data-urlencode 'currency=UAH' \
--data-urlencode 'txn=12345' \
--data-urlencode 'sign=7cc51cba32fa11732065caee398aeb956fb88b0ca8069f050854a632900f5d37'
| Параметр | Опис |
|---|---|
| token | Токен заявки на обмін |
| amount | Сума платежу |
| currency | Код валюти платежу |
| txn | Номер транзакції платежу |
| sign | Цифровий підпис SHA256(token:amount:currency:txn:СЕКРЕТНИЙ_КЛЮЧ) |
Опубліковано: 03.05.2023 11:59
© Exchanger CMS, 2018 - 2026. Скрипт обмінника валют. Усі права захищені.
Угода користувача