Постоянные адреса для депозита
Постоянные адреса используются для приема депозитов в криптовалюте без предварительного создания ордера со стороны мерчанта. Поступление суммы на депозит адрес иницирует создание нового ордера в системе FlyPay и результат ордера отправляется мерчанту на callback_url
.
Создание депозит адреса
Запрос
POST /v2/deposit_address/create
POST /v2/deposit_address/create HTTP/1.1
Content-Type: application/json
Accept: application/json; charset=utf-8
Api-key: {publicApiKey}
Signature: {signature}
{
"currency": "trx",
"network": "trc20",
"currency_to": "usdt" //optional
"callback_url": "", //optional
"address_title": "Test address", //optional
"client_info": { //optional
"client_id": "id1234",
"client_ip": "127.0.0.1",
"client_email": "[email protected]"
}
}
Описание параметров в запросе:
currency
– Валюта депозитаnetwork
– Сеть депозитаcurrency_to
– Валюта, в которую произвести обмен депозитаcallback_url
– URL адрес для сервер-сервер сообщения о поступлении депозитаaddress_title
– Название депозит адресаclient_info
– данные клиента в системе мерчанта: идентификатор, IP, email
Примечание
Актуальный список доступных валют и сетей для депозит адреса можно получить с помощью метода API rates
.
Проверяйте результаты для типа ордера deposit
при создании адресов без обмена и типа ордера deposit_exchange
при создании адресов с обменом.
Ответ
RESPONSE
HTTP/1.1 200 OK
Content-Type: application/json
{
/* The overall status of the request, not the order status */
"status": "success",
"data": {
"uuid": "e3ea9935-e3da-4ad5-bcaf-75067c812529",
"client_id": null,
"currency": "trx",
"network": "trc20",
"currency_to": "usdt",
"address_title": "Test address",
"address": "TVb4KtWABb9vyzMhiLm3cgFaE11MCZfvQu",
"memo": null,
"callback_url": null,
"created_at": "1970-01-01 14:48:53",
"min_amount": "4",
"max_amount": "100000",
"total_received_amount": null,
"total_received_deposits": null
}
}
Описание параметров в ответе:
uuid
– ID адреса в системе FlyPayclient_id
– ID клиента в системе мерчантаcurrency
– Валюта пополненияnetwork
– Сеть депозитаcurrency_to
– Валюта, в которую произвести обмен депозитаcallback_url
– URL адрес для сервер-сервер сообщения о поступлении депозитаaddress_title
– Название депозит адресаaddress
– Адрес в блокчейне, на который нужно отправить депозитmemo
– tag/memo адреса в блокчейне, на который нужно отправить депозитcreated_at
– Дата и время создания адреса в формате "Y-m-d H:i:s"min_amount
– Минимальная сумма депозитаmax_amount
– Максимальная сумма депозитаtotal_received_amount
– Сумма всех пополнений на данный адресtotal_received_deposits
– Количество депозитов на данный адрес
Получение списка депозит адресов
Запрос
POST /v2/deposit_address/list
POST /v2/deposit_address/list HTTP/1.1
Content-Type: application/json
Accept: application/json; charset=utf-8
Api-key: {publicApiKey}
Signature: {signature}
{
"currency": "usdt", //optional
"network": "trc20", //optional
"limit": 100, //optional, from 1 to 100
"page": 1 //optional
}
Описание параметров в запросе:
currency
– Валюта депозитаnetwork
– Сеть депозитаlimit
– Количество адресов в ответе, доступно от 1 до 100 (по умолчанию 100)page
– Номер страницы, с которой начинать выдачу результатов, 1 и больше (одна страница содержитlimit
адресов)
Ответ
RESPONSE
HTTP/1.1 200 OK
Content-Type: application/json
{
/* The overall status of the request, not the order status */
"status": "success",
"data": [
{
"uuid": "e3ea9935-e3da-4ad5-bcaf-75067c812529",
"client_id": null,
"currency": "trx",
"network": "trc20",
"currency_to": "usdt",
"address_title": "",
"address": "TVb4KtWABb9vyzMhiLm3cgFaE11MCZfvQu",
"memo": null,
"callback_url": null,
"created_at": "1970-01-01 14:48:53",
"min_amount": "4",
"max_amount": "100000",
"total_received_amount": null,
"total_received_deposits": null
}
]
}
Поле data
в ответе содержит массив найденых адресов.
Смотрите ответ при создании адреса с описанием полей данных отдельного адреса в ответе.