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