Кастомний мерчант
Останнє оновлення: 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