Поиск операции по TX-хешу
Метод позволяет найти операцию в системе по адресу транзакции в блокчейне
В ответе будет указан тип операции, направление транзакции, адрес, который использовался для операции и тело операции в записимости от типа
Доступные типы операций:
| Тип | Описание |
|---|---|
ORDER | Адрес транзакции был найден во входящих транзакциях ордера |
INVOICE | Адрес транзакции был найден во входящих транзакциях ордера созданного для исполнения счета |
ORPHAN_TRANSACTION | Адрес транзакции был во входящих транзакция адреса созданного для иной монеты или сети |
WITHDRAWAL | Адрес транзакции был найден среди операций вывода |
DEPOSIT | Адрес транзакции был найден во входящих транзакция адреса как "свободное пополнение" |
PERSONAL_DEPOSIT | Адрес транзакции был найден во входящих транзакциях по адресу системы "персональных адресов пользователей" |
Доступные направления транзакций:
| Направление | Описание |
|---|---|
IN | Входящая транзакция |
OUT | Исходящая транзакция |
Пример тела адреса:
{
"id": "cf95ea41-20c5-4528-b689-c21f4da6359f", // идентификатор адреса
"type": "PAY_IN" // тип адреса: PAY_IN, PERSONAL, PAY_OUT, BUSINESS, RECURRENT
}
В теле результата модет быть несколько записей, поэтому результат представлен в виде массива:
Пример тела ответа:
{
"success": true,
"response": [
{
"type": "OUT",
"source": "WITHDRAWAL",
"address": {
... // тело адреса
},
"result": {
... // тело для WITHDRAWAL
}
},
{
"type": "IN",
"source": "DEPOSIT",
"address": {
... // тело адреса
},
"result": {
... // тело для DEPOSIT
}
}
]
}
Пример тела операции PERSONAL_DEPOSIT:
{ // тело идентично телу отправляемому в вебхуке
"id": "2fa68ddf-2479-47cb-9e66-ae91139c3063", // идентификатор персонального депозита
"addressId": "dcb1a9fe-4b8d-40f6-baf6-241dc88436d9", // идентификатор адреса получателя
"userId": "6196a1f2-b6b5-40a5-a672-f1ffd70fdd7d", // идентификатор пользователя в системе для которого был создан адрес
"amount": "0.005", // сумма депозита
"currency": "USDT", // монета депозита
"addressFrom": ["0x....", "0x...."], // массив адресов отправителей
"addressTo": "0x....", // адрес получатель
"network": "bsc", // сети депозита
"status": "PROCESSED", // статус, доступные значение: PROCESSED
"tx": "0x5b9b3b55b366266025e...", // адрес транзакции в блокчейне
"createdAt": "2023-03-02T06:58:00.365Z",
"updatedAt": "2023-03-02T07:01:50.693Z"
}
Пример тела операции DEPOSIT:
{ // тело идентично телу отправляемому в вебхуке
"id": "2fa68ddf-2479-47cb-9e66-ae91139c3063", // идентификатор записи
"status": "processed", // статус, доступные значение: processed, error, rejected, pending
"addressType": "BUSINESS", // тип адреса: PAY_IN, PERSONAL, PAY_OUT, BUSINESS, RECURRENT
"addressFrom": "0x5b9b3b55b366266025e...", // адреса отправителя в блокчейне
"addressTo": "0x3f4e3d79a244189e25e...", // адрес получателя в блокчейне
"type": "deposit", // тип операции: withdrawal, deposit
"amount": "0.005", // сумма депозита
"currency": "USDT", // монета депозита
"network": "bsc", // сети депозита
"txId": "0x5b9b3b55b366266025e...", // адрес транзакции в блокчейне
"alias": "My address", // имя адреса указанное при создании
"comment": null, // комментарий к операции
"createdAt": "2023-03-02T06:58:00.365Z",
"updatedAt": "2023-03-02T07:01:50.693Z"
}
Пример тела операции WITHDRAWAL:
{ // тело ответа идентично телу ответа при получении данных вывода
"id": "2a2d464b-231a-baf3-6f8a-7b9dc0f8cef7", // идентификатор вывода в системе
"advancedBalanceId": "017f444f-a6ce-487f-0f80-9777199a6ff5", // идентификатор авансого баланса
"addressId": "5bcb11d2-cfe8-3a09-0c51-dd7be7243c5d", // идентификатор адреса отправителя
"currency": "ETH", // монета отправки
"network": "ethereum", // сеть отправки
"tx": "0x00000000000000000000c8950e52aa3...", // адрес транзакции в блокчейне
"status": "processed", // статус вывода: init, error, pending, processed, rejected
"address": "0x000000000c8950e52aa315030efedc861da658e2", // адрес получателя в блокчейне
"tag": null,
"amount": "2.12345", // сумма вывода
"feeAmount": "0.005", // сумма комиссии
"createdAt": "2023-03-02T07:01:50.693Z"
}
Пример тела операции ORDER:
{ // тело ответа идентично телу ответа запроса получения информации об ордере
"id": "d01d03e2-15dc-b03a-b34e-46cad2345b92", // ид ордера
"advancedBalanceId": "c6e7d8dc-ce10-637d-147b-2dda3015b8a4", // ид авансового баланса
"currency": "ETH", // монета оплаты
"network": "etehereum", // сеть оплаты
"link": "https://payment.domain/...", // ссылка на оплату
"status": "processed", // статус: init, error, processed, pending, expired, partial
"order": "#123456789",
"description": "Order #123456789",
"address": "0x000000000c8950e52aa315030efedc861da658e2", // адрес для приема оплаты
"addressId": "8eae79cf-1db2-4858-9023-aca473d805e2", // ид адреса в сисетеме
"tag": null, // тег адреса
"amount": "0.84", // сумма к оплате
"received": "0.86", // полученная сумма
"transactions": [
{
"id": "f0b22f11-007c-4f65-bb9b-265432ab64c3",
"status": "processed",
"currency": "BNB",
"network": "bsc",
"amount": "0.0001",
"tx": "0x8fb0d40678d1bb4b6c0b2095c18d9280aa8ccf966e778e6b209f4f71c7f1e835",
"confirmations": "15",
"sender": "0xcD62a4E08513f16F86C1c0AF0860DD6b3De1B83d",
"priceUSD": "212.90000000",
"amountUSD": "0.02129"
},
{
"id": "a2a7ed3b-a8af-42c4-900c-d21e1d9eda3c",
"status": "processed",
"currency": "BNB",
"network": "bsc",
"amount": "0.0006",
"tx": "0x60032c394fcc7a103bc2826f9b81e5086be90628331e1ce163e1c576c64baf06",
"confirmations": "15",
"sender": "0x54936CE809bBccC7f1378c7ec88F5504cE49605C",
"priceUSD": "212.70000000",
"amountUSD": "0.12762"
}
],
"orphanDeposits": [
{
"id": "7cd20ea9-0e2c-46c5-8e12-82b0485d5ba1",
"organizationId": "1f07eb01-5fd8-4e05-89b5-bebcd1d1fc39",
"orderId": "d01d03e2-15dc-b03a-b34e-46cad2345b92",
"stage": "WITHDRAWAL",
"status": "PROCESSED",
"message": null,
"currency": "BNB",
"network": "bsc",
"amount": "0.00000001",
"canWithdrawal": true,
"inTransaction": {
"addressType": "PAY_IN",
"addressId": "8519ba89-68d5-4914-9a0f-d99e77dc88ea",
"address": "0x68f8a74b5fD0b687369536607214acfA3b1572Ff",
"txId": "0x6751285829e38b1bb53d1df887dde750182f08e230b58a5a2d3e867ba7327362",
"amount": "0.00000001",
"status": "processed",
"createdAt": "2023-05-30T14:10:27.276Z"
},
"outTransaction": {
"withdrawalId": "4429ba89-68d5-4914-9a0f-d99e77dc88ea",
"address": "0x68f8a74b5fD0b687369536607214acfA3b1572Ff",
"txId": "0x5511285829e38b1bb53d1df887dde750182f08e230b58a5a2d3e867ba7327362",
"amount": "0.00000001",
"status": "processed",
"createdAt": "2023-05-30T14:10:27.276Z"
},
"createdAt": "2023-05-30T14:10:27.283Z"
}
],
"successWebhook": "https://example.com/success-webhook-url",
"errorWebhook": "https://example.com/error-webhook-url",
"returnUrl": "null",
"expiresAt": "2021-05-23T15:00:00Z",
"createdAt": "2021-05-23T15:00:00Z",
"updatedAt": "2021-05-23T15:00:00Z"
}
Пример тела операции INVOICE:
{ // тело ответа идентично телу ответа запроса получения данных счета
"id": "fe31e1f3-bd23-4c89-bced-7fecc60cbb34", // ID счета
"advancedBalanceId": "1cabe6ba-52b8-42bf-88a4-b3c953c3fd36", // ID авансового баланса
"orderId": "ae31e1f3-bd23-4c89-bced-7fecc60cbb31", // ID ордера (до статуса INIT будет null)
"orderLink": "https://payment.domain/...", // ссылка на ордер (до статуса INIT будет null)
"invoiceLink": "https://invoices.domain/...", // ссылка счета
"status": "PENDING", // статус счета (CREATED - создан, INIT - выбрана монета для оплаты, PENDING - пользователь сделал транзакцию, PROCESSED - оплачен, PARTIAL - частичная оплата, ERROR - ошибка, EXPIRED - срок жизни счета истек)
"order": "Order #1234",
"description": "Buy 1 Bitcoin",
"currency": "USD",
"amount": "3000",
"receivedCurrency": "USDT", // выбраная монета для оплаты (до статуса INIT будет null)
"receivedAmount": "123", // полученная сумма
"includeFee": true,
"insurancePercent": "2",
"slippagePercent": "3.5",
"webhookURL": "https://my-shop.com/api/webhooks",
"returnURL": "https://my-shop.com/",
"currencies": [
{
"currency": "USDT",
"networks": [
{
"name": "tron",
"amount": "3030.123" // конечная сумма к оплате для USDT в сети tron
},
{
"name": "bsc",
"amount": "3030.123"
}
]
}
],
"expiresAt": "2022-12-16T08:36:38.130Z",
"createdAt": "2022-12-16T07:36:38.130Z"
}
Пример тела операции ORPHAN_DEPOSIT:
{ // тело ответа идентично телу ответа запроса получения данных депозита
"id": "7cd20ea9-0e2c-46c5-8e12-82b0485d5ba1",
"organizationId": "1f07eb01-5fd8-4e05-89b5-bebcd1d1fc39",
"orderId": "4db8ba00-20f8-4e3f-8292-301dd66618af",
"stage": "WITHDRAWAL",
"status": "PROCESSED",
"message": null,
"currency": "BNB",
"network": "bsc",
"amount": "0.00000001",
"canWithdrawal": true,
"inTransaction": {
"addressType": "PAY_IN",
"addressId": "8519ba89-68d5-4914-9a0f-d99e77dc88ea",
"address": "0x68f8a74b5fD0b687369536607214acfA3b1572Ff",
"txId": "0x6751285829e38b1bb53d1df887dde750182f08e230b58a5a2d3e867ba7327362",
"amount": "0.00000001",
"status": "processed",
"createdAt": "2023-05-30T14:10:27.276Z"
},
"outTransaction": {
"withdrawalId": "4429ba89-68d5-4914-9a0f-d99e77dc88ea",
"address": "0x68f8a74b5fD0b687369536607214acfA3b1572Ff",
"txId": "0x5511285829e38b1bb53d1df887dde750182f08e230b58a5a2d3e867ba7327362",
"amount": "0.00000001",
"status": "processed",
"createdAt": "2023-05-30T14:10:27.276Z"
},
"createdAt": "2023-05-30T14:10:27.283Z"
}
Last updated