Интерфейс получения адреса кошелька криптовалюты (BTC) по номеру аккаунта пользователя
Команда выполняет генерацию адреса кошелька в криптовалюте (BTC, Eth и др.) и привязку его к аккаунту пользователя. Если пользователь произведет пополнение адреса кошелька (ADDRESS), полученного в ответ на данный запрос, Продавцу будет отправлено оповещение об успешном платеже. Сопоставление аккаунта при получении оповещения должно производиться по параметру LMI_PAYER_ID. В оповещении в LMI_PAYER_IDENTIFIER будет указан адрес кошелька (ADDRESS), в LMI_PAYMENT_AMOUNT - сумма в валюте мерчанта (зависит от настроек магазина и может быть не равна валюте криптокошелька), в LMI_TXID - идентификатор платежа в блокчейн.
Параметры передаются в виде XML методом POST.
Action - https://api.paysoft.solutions/merchants/get-wallet
Формат XML-запроса:
<Command>
<LMI_MERCHANT_ID></LMI_MERCHANT_ID>
<LMI_PAYER_ID></LMI_PAYER_ID>
<LMI_PAYMENT_SYSTEM></LMI_PAYMENT_SYSTEM>
<LMI_GENEREATE_NEW></LMI_GENEREATE_NEW>
<LMI_REQUEST_DATE></LMI_REQUEST_DATE>
<LMI_HASH></LMI_HASH>
</Command>
| Название | Название параметра в html-форме | Обязательный? | Описание |
|---|---|---|---|
| Идентификатор продавца | LMI_MERCHANT_ID | Да | Идентификатор магазина. Идентификатор Продавец может получить в Кабинете (https://merchant.paysoft.solutions). |
| Идентификатор клиента на стороне Продавца | LMI_PAYER_ID | Да | Может содержать буквы английского алфавита, цифры и знак дефиса «-». Максимальная длина 25 символов. |
| Идентификатор криптовалюты | LMI_PAYMENT_SYSTEM | Да | Числовой идентификатор платежного инструмента, определяет тип криптовалюты |
| Создать новый кошелек | LMI_GENEREATE_NEW | Нет | Можете принимать значения 0 - при повторном запросе для одинакового LMI_PAYER_ID будет возвращаться одинаковый ADDRESS (адрес кошелька) или 1 - при повторном запросе для одинакового LMI_PAYER_ID будет возвращаться новый ADDRESS. Значение по умолчанию - 0. |
| Время запроса | LMI_REQUEST_DATE | Да | Время запроса, должно быть равно текущей дате в формате YYYY-MM-DD HH:II:SS . Время запроса не должно отличаться от текущего времени более, чем на 2 минуты |
| Контрольная подпись | LMI_HASH | Да | Контрольная подпись запроса. Для формирования подписи исходный текст XML-запроса с пустым значением LMI_HASH конкатенируется с секретным ключом SecretKey (без разделителя). От полученной строки формируется хеш сумма с помощью алгоритма, указанного в настройках магазина в Кабинете Продавца. Полученная подпись передается в теге LMI_HASH. Рекомендованный алгоритм хеширования SHA256.Пример формирования подписи |
Формат XML-ответа:
<Response>
<Retval></Retval>
<Retdesc></Retdesc>
<Retdata>
<LMI_PAYER_ID></LMI_PAYER_ID>
<LMI_PAYMENT_SYSTEM></LMI_PAYMENT_SYSTEM>
<ADDRESS></ADDRESS>
<CURRENCY_CODE></CURRENCY_CODE>
</Retdata>
<LMI_HASH></LMI_HASH>
</Response>
| Название | Поле в XML | Описание | |
|---|---|---|---|
| Код выполнения запроса | Retval | 0 - успешное выполнение команды; 1 - Некорректная подпись (LMI_HASH); 2 – некорректные параметры; 4,5,6,7 – внутренняя ошибка; | |
| Описание кода выполнения | Retdesc | ||
| Идентификатор клиента на стороне Продавца | LMI_PAYER_ID | ||
| Идентификатор платежного инструмента | LMI_PAYMENT_SYSTEM | Идентификатор платежного инструмента, определяет тип криптовалюты | |
| Адрес криптокошелька | ADDRESS | Сгенерированный адрес кошелька криптовалюты закреплённый за аккаунтом пользователя LMI_PAYER_ID. | |
| Код валюты | CURRENCY_CODE | Текстовое представление кода криптовалюты (например, BTC) | |
| Контрольная подпись | LMI_HASH | Да | Контрольная подпись ответа. Формируется аналогично LMI_HASH из запроса |