Постійні адреси для депозиту

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