Перейти к содержанию

Операции в криптовалюте

Вариант интеграции XP

Систeма MF STREAM позволяет вам проводить операции оплаты и выплаты в криптовалюте. Этот способ оплаты поддерживает работу со следующими криптовалютами:

Название криптовалюты Код криптовалюты Стандарт криптовалюты
Название криптовалюты Код криптовалюты Стандарт криптовалюты
Ethereum ETH
Tether USDT ERC20
Передавайте в запросах как пустую строку ("").
Tether USDT TRC20
Tether USDT BEP20
Binance USD BUSD BEP20
Binance USD BUSD ERC20
Передавайте в запросах как пустую строку ("").
Bitcoin BTC
Dai DAI ERC20
Передавайте в запросах как пустую строку ("").
Dai DAI BEP20
Dash DASH
Dogecoin DOGE
HUSD HUSD ERC20
Передавайте в запросах как пустую строку ("").
Litecoin LTC
TrueUSD TUSD ERC20
Передавайте в запросах как пустую строку ("").
USD Coin USDC ERC20
Передавайте в запросах как пустую строку ("").
USD Coin USDC BEP20
XRP XRP
Huobi Token HT TRC20
HUSD HUSD TRC20
Ethereum ETH TRC20
Ethereum ETH BEP20
TRON TRX
BNB BNB
Cardano ADA BEP20
CasinoCoin CSC Ripple
Dexsport DESU BEP20
Axie Infinity AXS TRC20
Axie Infinity AXS ERC20
Передавайте в запросах как пустую строку ("").
Bitcoin BEP2 BTCB BEP20

Оплата

Процесс проведения платежа в криптовалюте содержит следующие этапы:

  1. Покупатель инициирует проведение оплаты в выбранной криптовалюте.
  2. Торговец выполняет запрос на формирование виджета, на создание токена платежа в случае его использования или запрос на проведение оплаты с параметрами, указанными ниже.
    • В случае интеграции с виджетом, виджет MF STREAM покажет покупателю инструкцию о проведении оплаты c QR-кодом.
    • В случае API запроса торговец самостоятельно формирует страницу с инструкцией о проведении оплаты, используя значения параметров, полученных в ответе на запрос.
  4. Покупатель проводит платеж согласно полученной инструкции.
  5. MF STREAM получает информацию о платеже. Покупатель видит результат проведения платежа в виджете. Торговцу приходит автоматическое уведомление о статусе платежа, если в запросе на формирование виджета и в запросе на проведение оплаты был передан параметр notification_url.

Info

В автоматических уведомлениях сумма транзакции указывается как сумма платежа, умноженная на 100 000 000 и округленная согласно правилам математического округления.

Info

QR код действителен только в течении 30 минут.

Запрос

Параметры для инициализации виджета или создания токена

Отправьте запрос на формирование виджета или создание токена платежа, где укажите следующие дополнительные параметры:
object
Секция параметров платежа.
amount
обязательный
 integer
Следует установить в значении 0. Сумма оплаты будет указана в автоматическом уведомлении.
currency
обязательный
 string
Код криптовалюты. Список возможных значений смотрите в таблице выше или в справочнике кодов криптовалют.
object
Секция информации о способах оплаты.
types
обязательный
 array
Массив способов оплаты для отображения покупателю. Добавьте crypto_currency как элемент этого массива.
object
Секция параметров оплаты криптовалютой.
token_standard
обязательный
 string
Стандарт криптовалюты. Список возможных значений смотрите выше.
tag
условно обязательный
 string
ID получателя оплаты. Обязательный параметр для платежей в TRX.

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

Для приема платежа проведите транзакцию оплаты со следующими дополнительными параметрами:
amount
обязательный
 integer
Следует установить в значении 0. Сумма оплаты будет указана в автоматическом уведомлении.
currency
обязательный
 string
Код криптовалюты. Список возможных значений смотрите в таблице выше или в справочнике кодов криптовалют.
object
Секция данных платежного метода.
type
обязательный
 string
Следует установить в значении crypto_currency.
token_standard
обязательный
 string
Стандарт криптовалюты. Список возможных значений смотрите выше.
tag
условно обязательный
 string
ID получателя оплаты. Обязательный параметр для платежей в TRX.
Ответ

В случае интеграции с виджетом, покупатель получает инструкцию о проведении оплаты c QR-кодом в виджете MF STREAM.

В случае API интеграции, ответ на запрос оплаты будет дополнительно содержать секцию crypto_currency со следующими параметрами:
object
Секция параметров оплаты криптовалютой.
type
 string
crypto_currency.
currency
 string
Код криптовалюты.
id
 string
Идентификатор платежа в системе провайдера.
minimumAmount
 string
Минимально допустимая сумма платежа в выбранной валюте.
address
 string
ID получателя оплаты.
destinationTag
 string
ID получателя оплаты для платежей в TRX.
rate
 string
Комиссия, взимая за платеж в выбранной валюте.
qrCode
 string
QR код, закодированный в Base64.
expDate
 string
Время окончания срока действия QR кода по UTC.

Используйте значения параметров при построении формы для отображения соответствующей информации покупателям.

Выплата средств

Процесс проведения выплаты в криптовалюте содержит следующие этапы:

  1. Покупатель инициирует проведение выплаты в выбранной криптовалюте.
  2. Торговец выполняет запрос на выплату средств с параметрами, указанными ниже.
  3. Система проверяет баланс и проводит выплату.
  4. Торговцу приходит автоматическое уведомление о статусе платежа, если в запросе на проведение выплаты был передан параметр notification_url.

Info

В автоматических уведомлениях сумма транзакции указывается как сумма выплаты, умноженная на 100 000 000 и округленная согласно правилам математического округления.

Запрос

Отправьте запрос выплаты средств со следующими данными:
amount
обязательный
 integer
Сумма выплаты. Укажите значение параметра как количество денежных единиц криптовалюты, умноженное на 100 000 000. Больше информации в справочнике кодов криптовалют.
currency
обязательный
 string
Название криптовалюты. Список возможных значений смотрите в таблице выше или в справочнике кодов криптовалют.
object
Секция данных платежного метода.
type
обязательный
 string
Следует установить в значении crypto_currency.
recipient_wallet_id
обязательный
 string
Номер кошелька получателя выплаты.
token_standard
обязательный
 string
Стандарт криптовалюты. Список возможных значений смотрите выше.
tag
условно обязательный
 string
ID получателя выплаты. Обязательный параметр для платежей в TRX.
Ответ

Ответ на запрос оплаты будет дополнительно содержать секцию crypto_currency с указанием параметров способа оплаты.