
Пілот API гаманців для TRON і USDT має підтвердити три речі, перш ніж ви розширите інтеграцію. Один депозит зараховується потрібному клієнту, налаштоване правило погодження зупиняє одну виплату до підписання, а операційна команда може пояснити підсумковий баланс за записами транзакцій і журналу. Узгодьте потрібні докази для кожної перевірки до першого переказу.
Якщо ви ще формуєте короткий список постачальників, почніть із порівняння API криптогаманців. Коли оберете кандидата, скористайтеся цим планом, щоб визначити, чи готова інтеграція до ширших випробувань.
Підготуйте один гаманець і одне правило погодження
Використайте окремі пілотні акаунт і гаманець, контрольовану депозитну адресу TRON, прив’язану до одного тестового клієнта, а також відправника й отримувача під контролем команди пілота. Узгодьте суму депозиту й виплати, початкові баланси, часове вікно спостереження та очікувані зміни балансу. Для перевірки відхилення підготуйте коректну за рештою умов виплату з достатнім балансом і виберіть одне правило Co-Signer, яке заявка свідомо порушить. Звірте правило, докази його спрацювання й критерій підтвердження депозиту з чинним контрактом і налаштуваннями пілотного акаунта. Використовуйте погоджене середовище, яке підтримує цей сценарій. Якщо випробування потребує реального переказу, заздалегідь узгодьте суму й допустимий ризик.
Зафіксуйте початковий баланс до переказу коштів. Уникайте сторонніх операцій у гаманці протягом випробування. Запишіть акаунт, гаманець, мережу, актив і часові позначки. Призначте одну людину для проведення пілота, а іншу — для перевірки доказів.
Про етапи погодження й підписання читайте в матеріалі як погоджувати виплати USDT у мережі TRON.
Матриця приймання
| Перевірка | Дія | Критерій проходження | Що зберегти |
|---|---|---|---|
| Один депозит USDT у мережі TRON | Надішліть один контрольований переказ на прив’язану депозитну адресу. Відстежте його до виконання погодженого критерію підтвердження. | Транзакція має тип DEPOSIT і належить потрібним акаунту й гаманцю. Після виконання погодженого критерію API показує CONFIRMED, а застосунок рівно один раз зараховує потрібному клієнту очікувану суму USDT. | ID депозитної транзакції, хеш у мережі, доказ підтвердження, ID гаманця й акаунта, amountAtomic і запис про зарахування в застосунку. |
| Одна виплата, відхилена за правилом | Подайте коректну за рештою умов заявку, що порушує вибране правило Co-Signer. Зафіксуйте рішення й перевірте ознаки підписання та відправлення в мережу протягом погодженого часу. | Запис рішення вказує на потрібне правило й підтверджує зупинку заявки до штатного підписання A+B. Ознак відправлення в мережу немає, а звірка не показує остаточного списання за цією виплатою. | Ідентифікатор заявки, рішення за правилом, результати перевірки підписання й відправлення та ID транзакції, якщо середовище створює такий запис. |
| Звірка з журналом | Отримайте депозитну транзакцію та пов’язані записи журналу гаманця. Якщо для виплати є запис транзакції, отримайте і її записи журналу. Порівняйте проведені зміни з власним обліком і кінцевим балансом. | Підтверджений депозит простежується від мережі через транзакцію й журнал до зарахування клієнту. Кожна проведена зміна в межах пілота має пояснення, зокрема відображені комісії, якщо вони застосовувалися. Тимчасові зміни за виплатою врегульовано за погодженими правилами, а кінцевий баланс дорівнює початковому з урахуванням чистої суми проведених змін. | ID транзакцій і записів журналу, суми й напрями, початковий і кінцевий баланси та висновок звірки. |

Перевірте транзакцію та її вплив на облік
У BroSettlement скористайтеся GET /api/v1/transactions із дозволом transactions:read, щоб знайти депозит за txHash. Якщо ідентифікатор заявки на виплату передано й збережено, шукайте за clientReference та за потреби звузьте результати за акаунтом або гаманцем. Прочитайте кожну знайдену транзакцію через GET /api/v1/transactions/{id}. Запишіть id, accountId, walletId, chain, asset, type, status і amountAtomic. Наявність чи вміст balanceEffects і onChainDetails можуть залежати від стану транзакції. Про саму процедуру читайте в посібнику з інтеграції депозитів USDT у мережі TRON.
Скористайтеся GET /api/v1/wallets/{walletId}/ledger-entries із дозволом wallets:read та фільтром transactionId, якщо маєте цей ідентифікатор. Перевірте direction, status, asset і amountAtomic кожного запису. Рахуйте в атомарних одиницях і враховуйте напрям кожного запису POSTED, щоб визначити чисту зміну для пілотного гаманця й активу. Записи PENDING і VOIDED зафіксуйте окремо. Зіставте результат із зарахуванням клієнту й кінцевим балансом у застосунку. Production OpenAPI · Довідка про журнал англійською
Вирішіть, чи розширювати пілот
Для кожного рядка зафіксуйте результат: пройдено, не пройдено або бракує доказів. Зарахування іншому клієнту, непояснена проведена зміна або ознаки того, що відхилена заявка дійшла до підписання чи відправлення в мережу, означають провал відповідної перевірки. Якщо бракує доказу спрацювання правила або депозит ще не досяг погодженого порога підтвердження, результат залишається невизначеним. Додавайте гаманці чи активи після проходження всіх трьох перевірок і відтворення звірки за збереженими записами.
Поширені запитання
Який статус API доводить, що виплату відхилено за правилом?
Використовуйте запис рішення за правилом і доступні у вашому середовищі докази щодо підписання та відправлення в мережу. Перелік станів транзакції BroSettlement містить PENDING, CONFIRMED, FAILED і FAILED_ON_CHAIN. Сам по собі FAILED не вказує, яке правило зупинило заявку. Звірте з чинним контрактом, яку відповідь повертає відхилення і чи створюється запис транзакції.
Скільки підтверджень TRON потрібно для пілота?
Керуйтеся умовами підтвердження та зарахування, налаштованими для пілотного акаунта за його чинним API-контрактом. Зафіксуйте умову до переказу коштів, щоб перевіряльник міг визначити момент завершення тесту депозиту.
