Кастомний мерчант
Останнє оновлення: 03.05.2023 08: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:СЕКРЕТНИЙ_КЛЮЧ)
Працюємо без вихідних 10:00 - 20:00 (GMT+3)
© 2018 - 2024 Зроблено з Exchanger CMS