Перейти к основному содержимому

Постоянные адреса для депозита

Постоянные адреса используются для приема депозитов в криптовалюте без предварительного создания ордера со стороны мерчанта. Поступление суммы на депозит адрес иницирует создание нового ордера в системе 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 адреса в системе FlyPay
  • client_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 в ответе содержит массив найденых адресов. Смотрите ответ при создании адреса с описанием полей данных отдельного адреса в ответе.