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

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

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