Интерфейс мерчанта LocalCAG

LocalCAG (Local Cryptocurrency Address Generator) - это интерфейс мерчанта обработки входящих платежей для направлений обмена работающих с криптовалютой, позволяет генерировать адреса для оплаты и производить проверку платежа на локальном или удаленном сервере, с использованием логики написанной на любом языке программирования.

Заявка на обмен с установленным мерчантом LocalCAG

Если мерчант LocalCAG установлен в качестве мерчанта обработки входящих платежей для нужного направления обмена или заявки на обмен, на странице с заявкой начнется процесс генерации адреса для оплаты.

Заявка на обмен с установленным мерчантом LocalCAG

Происходит отправка POST запроса на адрес хоста, который был указан в панеле управления в разделе "Настройки приложения" — "Настройка мерчанта LocalCAG". Секретный ключ SECRET_KEY будет выслан в HTTP заголовке X-Authorization.

Пример запроса на получение адреса для оплаты отправляемым обменником:

POST https://dev.exchanger-cms.com/local-cag 
Content-Type: application/x-www-form-urlencoded 
Header: X-Authorization SECRET_KEY 

0=4809ce4de99b882bce8731687a967a1a 
1=0.84930000 
2=ETH 
3=8 
4=NULL 
5=23999.58 
6=RUB 
7=2 
8=4276132242771240 

Обработка ответа:

Пример успешного ответа:

{ 
    "success":true, 
    "result":{ 
        "merchant_local_cag_address":"0x72323da5d152e1c688377fa9e0f23a6cb06598be" 
    } 
}

Пример неуспешного ответа:

{ 
    "success":false, 
    "result":false 
}

Ответ сервера должен быть в формате json.

В результате адрес для оплаты 0x72323da5d152e1c688377fa9e0f23a6cb06598be будет отображен на странице с заявкой. В ответ так же могут быть включены дополнительные, не обязательные данные, которые будут доступны к просмотру в панеле управления на странице редактирования заявки на обмен, во вкладе "Переменные".

После успешной обработки платежа необходимо отправить оповещение в виде POST запроса на URL адрес обменника ./merchant-process/local-cag. Если цифровая подпись сформирована верно и остальные данные соответствуют указанным в заявке на обмен, происходит изменение статуса на "Оплачена".

Пример запроса для отправки оповещения:

POST https://test.exchanger-cms.com/merchant-process/local-cag 
Content-Type: application/x-www-form-urlencoded 

order_token=4809ce4de99b882bce8731687a967a1a 
amount=0.84930000 
currency=ETH 
txn=test_txn_1601790302 
sign=7cc51cba32fa11732065caee398aeb956fb88b0ca8069f050854a632900f5d37

Параметры запроса:

Алгоритм формирования цифровой подписи:

SHA256(amount:currency:order_token:txn:SECRET_KEY)