Документация
Руководство пользователя
Продукты
Разработчикам
Кастомный мерчант
Последнее обновление: 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. Скрипт обменника валют. Все права защищены.
Пользовательское соглашение