Операции в криптовалюте
Вариант интеграции XP
Систeма bePaid позволяет вам проводить операции оплаты и выплаты в криптовалюте. Этот способ оплаты поддерживает работу со следующими криптовалютами:
| Название криптовалюты | Код криптовалюты | Стандарт криптовалюты |
|---|---|---|
| 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 |
Оплата
Процесс проведения платежа в криптовалюте содержит следующие этапы:
- Покупатель инициирует проведение оплаты в выбранной криптовалюте.
- Торговец выполняет запрос на формирование виджета, на создание токена платежа в случае его использования или запрос на проведение оплаты с параметрами, указанными ниже.
-
- В случае интеграции с виджетом, виджет bePaid покажет покупателю инструкцию о проведении оплаты c QR-кодом.
- В случае API запроса торговец самостоятельно формирует страницу с инструкцией о проведении оплаты, используя значения параметров, полученных в ответе на запрос.
- Покупатель проводит платеж согласно полученной инструкции.
- bePaid получает информацию о платеже. Покупатель видит результат проведения платежа в виджете. Торговцу приходит автоматическое уведомление о статусе платежа, если в запросе на формирование виджета и в запросе на проведение оплаты был передан параметр
notification_url.
Info
В автоматических уведомлениях сумма транзакции указывается как сумма платежа, умноженная на 100 000 000 и округленная согласно правилам математического округления.
Info
QR код действителен только в течении 30 минут.
Запрос
Параметры для инициализации виджета или создания токена
Отправьте запрос на формирование виджета или создание токена платежа, где укажите следующие дополнительные параметры:
| Параметр | Тип | Описание |
|---|---|---|
| order | object | Секция параметров платежа. |
| amount * обязательный |
integer | Следует установить в значении 0. Сумма оплаты будет указана в автоматическом уведомлении. |
| currency * обязательный |
string | Код криптовалюты. Список возможных значений смотрите в таблице выше или в справочнике кодов криптовалют. |
| payment_method | object | Секция информации о способах оплаты. |
| types * обязательный |
array | Массив способов оплаты для отображения покупателю. Добавьте crypto_currency как элемент этого массива. |
| crypto_currency | object | Секция параметров оплаты криптовалютой. |
| token_standard * обязательный |
string | Стандарт криптовалюты. Список возможных значений смотрите выше. |
| tag * условно обязательный |
string | ID получателя оплаты. Обязательный параметр для платежей в TRX. |
Параметры API запроса
Для приема платежа проведите транзакцию оплаты со следующими дополнительными параметрами:
| Параметр | Тип | Описание |
|---|---|---|
| amount * обязательный |
integer | Следует установить в значении 0. Сумма оплаты будет указана в автоматическом уведомлении. |
| currency * обязательный |
string | Код криптовалюты. Список возможных значений смотрите в таблице выше или в справочнике кодов криптовалют. |
| method | object | Секция данных платежного метода. |
| type * обязательный |
string | Следует установить в значении crypto_currency. |
| token_standard * обязательный |
string | Стандарт криптовалюты. Список возможных значений смотрите выше. |
| tag * условно обязательный |
string | ID получателя оплаты. Обязательный параметр для платежей в TRX. |
Ответ
В случае интеграции с виджетом, покупатель получает инструкцию о проведении оплаты c QR-кодом в виджете bePaid.
В случае API интеграции, ответ на запрос оплаты будет дополнительно содержать секцию crypto_currency со следующими параметрами:
| Параметр | Тип | Описание |
|---|---|---|
| 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. |
Используйте значения параметров при построении формы для отображения соответствующей информации покупателям.
Выплата средств
Процесс проведения выплаты в криптовалюте содержит следующие этапы:
- Покупатель инициирует проведение выплаты в выбранной криптовалюте.
- Торговец выполняет запрос на выплату средств с параметрами, указанными ниже.
- Система проверяет баланс и проводит выплату.
- Торговцу приходит автоматическое уведомление о статусе платежа, если в запросе на проведение выплаты был передан параметр
notification_url.
Info
В автоматических уведомлениях сумма транзакции указывается как сумма выплаты, умноженная на 100 000 000 и округленная согласно правилам математического округления.
Запрос
Отправьте запрос выплаты средств со следующими данными:
| Параметр | Тип | Описание |
|---|---|---|
| amount * обязательный |
integer | Сумма выплаты. Укажите значение параметра как количество денежных единиц криптовалюты, умноженное на 100 000 000. Больше информации в справочнике кодов криптовалют. |
| currency * обязательный |
string | Название криптовалюты. Список возможных значений смотрите в таблице выше или в справочнике кодов криптовалют. |
| method | object | Секция данных платежного метода. |
| type * обязательный |
string | Следует установить в значении crypto_currency. |
| recipient_wallet_id * обязательный |
string | Номер кошелька получателя выплаты. |
| token_standard * обязательный |
string | Стандарт криптовалюты. Список возможных значений смотрите выше. |
| tag * условно обязательный |
string | ID получателя выплаты. Обязательный параметр для платежей в TRX. |
Ответ
Ответ на запрос оплаты будет дополнительно содержать секцию crypto_currency с указанием параметров способа оплаты.