Кастомный мерчант
Содержание
Принцип работы
Используя кастомный мерчант, можно самостоятельно генерировать реквизиты, 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 - 2023 Сделано с Exchanger CMS