Як інтегрувати депозити USDT у мережі TRON із BroSettlement

Прив’язуйте депозити USDT у мережі TRON до клієнтів, зараховуйте кошти один раз і звіряйте пропущені депозити після розриву WebSocket.

StablecoinsPaymentsIntegration
Депозит USDT у мережі TRON проходить від призначеної адреси отримання через перевірки транзакції та журналу до доступності коштів для витрачання.

Перш ніж зробити депозит доступним для витрачання, звірте адресу отримання та її прив’язку до клієнта, прочитайте актуальний запис транзакції, знайдіть відповідний проведений кредитовий запис і перевірте правила доступності коштів у продукті. Якщо кошти можна використати одразу, збережіть факт застосування запису й зміну балансу в одній транзакції бази даних. Тоді повторне сповіщення або звірка знайдуть той самий запис без повторного зарахування.

BroSettlement надає API читання транзакцій, операційний журнал гаманця й сповіщення про перебіг обробки через WebSocket. Посібник охоплює шлях від призначення адреси до поповнення доступного балансу й два способи знайти незавершені операції після розриву з’єднання. Приклади читання відповідають зрізу production Integration API v1.0 від 18 листопада 2026 року. Перевірте активований актив, умови фінальності та можливості доставки подій за чинним контрактом інтеграції. Довідник BroSettlement API · Production OpenAPI

Зміст

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

Перш ніж показати адресу отримання, збережіть її прив’язку до внутрішнього рахунку клієнта, якому потрібно зарахувати кошти. Зафіксуйте ідентифікатори рахунку й гаманця BroSettlement, адресу отримання, мережу й актив, для яких ви надаєте цю адресу. За цими записами підтримка й фінансова команда зможуть знайти переказ, навіть якщо на екрані клієнта вже інша адреса. Після заміни або припинення використання адреси зберігайте попередню прив’язку стільки, скільки потрібно для опрацювання пізніх переказів і розбору розбіжностей.

Показуйте мережу, актив і адресу разом. Для цього сценарію вкажіть USDT у мережі TRON. Перевірте, що актив доступний у цій мережі для вашої інтеграції, і використовуйте ідентифікатори мережі й активу з чинного контракту. Позначення токена або знімок екрана від клієнта допоможуть знайти звернення. Актив і адресу призначення встановлюйте за записами провайдера. Під час порівняння адреси отримання зі збереженою прив’язкою дотримуйтеся контрактних правил представлення адрес.

Для знайденого депозиту використайте accountId і walletId, щоб знайти прив’язку до клієнта. Звірте мережу, актив, адресу отримання й суму у форматі, визначеному чинним контрактом. Якщо адресу неможливо зіставити зі збереженою прив’язкою або записи вказують на різних отримувачів, залиште доступний баланс без змін і відкрийте випадок для звірки. Зафіксуйте, яку прив’язку перевіряли та в чому полягає розбіжність.

Перевіряйте суми без округлення. Поле amountAtomic містить суму в атомарних одиницях. Зберігайте й порівнюйте її точно, а для показу застосовуйте налаштовану розрядність активу. Зіставте суму депозиту й відповідного кредитового запису за правилами контракту. Якщо зв’язок між записами неясний, збережіть обидва для перевірки. Очікувана сума від клієнта може звузити пошук, а суму для зарахування визначають перевірені записи транзакції й журналу.

Події, стани транзакцій і записи журналу

deposit.observed означає, що переказ виявлено. deposit.confirmed означає, що переказ відповідає правилам підтвердження провайдера. За будь-яким із цих сповіщень заплануйте читання актуальної транзакції. Якщо поточні записи показують очікуваний депозит, застосунок може показати його в цьому стані до перевірки журналу й доступності коштів. Розраховуйте на доставку щонайменше один раз. Повторні сповіщення розпізнавайте за стабільним ідентифікатором події. Перевірте, які події, підписки за темами, підтвердження отримання та механізми поновлення потоку підтримує інтеграція. Події WebSocket

Відому операцію перевіряйте через GET /api/v1/transactions/{id} із дозволом transactions:read. Перевірте type=DEPOSIT і прочитайте актуальний статус разом із даними рахунку, гаманця, мережі, активу й суми. Детальний запис містить id, accountId, walletId, chain, asset, amountAtomic, createdAt і updatedAt. Наявність balanceEffects і onChainDetails може залежати від стану операції. Адресу отримання перевіряйте у форматі, який підтримує чинний контракт.

Прочитайте GET /api/v1/wallets/{walletId}/ledger-entries із дозволом wallets:read. Фільтр transactionId звужує вибірку до потрібного депозиту. Для кожного потенційного зарахування перевірте зв’язок із транзакцією та гаманцем, мережу, актив, суму, статус і кредитовий напрям, визначений контрактом для відповідного рахунку. У перевірках використовуйте задокументовані назви полів і значення статусів. Production OpenAPI · Операційний журнал

ЗаписЩо перевірятиДія застосунку
Сповіщення WebSocketdeposit.observed або deposit.confirmedЗапланувати або повторити перевірку. Визначити стан для клієнта за актуальними записами.
ТранзакціяDEPOSIT, PENDINGЗалишити депозит на контролі, а доступні кошти без змін.
ТранзакціяDEPOSIT, CONFIRMEDПеревірити застосовні вимоги до підтвердження й знайти відповідний проведений кредитовий запис.
ТранзакціяFAILED або FAILED_ON_CHAINПризупинити нове зарахування. Розібрати суперечність із попереднім зарахуванням, якщо воно було.
Запис журналуPENDING або VOIDEDВиключити запис із нових зарахувань. Перевірити суперечність із раніше застосованим записом.
Запис журналуPOSTED, відповідний кредитовий напрям, перевірені прив’язка й сумаЗарахувати один раз, коли перевірено транзакцію та умови доступності.
Баланс застосункуЗбережені ідентифікатор застосованого запису та його вплив на балансПоказати кошти за правилами доступності й використати запис про застосування для обробки повторів.

Ці записи можуть відповідати різним етапам. Транзакція вже може мати стан CONFIRMED, коли кредитовий запис ще PENDING або відсутній. Залиште депозит відкритим і повторіть читання журналу. Змінюйте доступний баланс після виконання умов доступності та фіксації локальної зміни. Якщо продукт показує очікувану суму, позначайте її окремо. Для дозволу на витрачання або виведення використовуйте доступний баланс. Тоді підтримка зможе пояснити, чи депозит чекає підтвердження, проведення запису або рішення про доступність.

Кожне з двох сповіщень про депозит запускає читання транзакції. Після перевірки відповідного проведеного запису журналу й умов доступності застосунок зараховує кошти один раз.

Одноразове зарахування за проведеним записом

Окремо обліковуйте повтори сповіщень і застосовані зарахування. Стабільний ідентифікатор події допомагає розпізнати повторне сповіщення. Ідентифікатор перевіреного запису журналу визначає обліковий ефект, який застосунок має відобразити. Сповіщення про виявлення, підтвердження, планова звірка й ручна перевірка підтримкою можуть привести до одного запису. Усі ці шляхи мають використовувати одну операцію зарахування та спільний реєстр застосованих записів.

За чинним контрактом перевірте стабільність ідентифікатора запису й межі його унікальності. Додайте до ключа контекст середовища провайдера та, якщо цього вимагає контракт, рахунку або гаманця. Хеш блокчейн-транзакції допомагає простежити переказ. Для обліку застосунку потрібен ідентифікатор конкретного ефекту. Збережіть його разом з ідентифікаторами транзакції, гаманця та внутрішнього рахунку клієнта, а також активом і сумою.

Застосуйте обмеження унікальності в базі даних, щоб одночасна робота двох обробників дала одне зарахування. В одній транзакції бази зареєструйте вихідний запис за унікальним ключем і зафіксуйте його обліковий ефект. Якщо кошти доступні одразу й застосунок зберігає розрахований доступний баланс, оновіть його в тій самій транзакції. Якщо доступність настає пізніше, окремо фіксуйте проведений запис і рішення про доступність. Застосування рішення також має бути ідемпотентним. Передбачте одночасне опрацювання двох різних зарахувань на один рахунок так, щоб кожна зміна відобразилася в балансі.

Якщо ключ уже існує, порівняйте клієнта, гаманець, актив і суму зі збереженим записом. За збігу зберігайте початкове зарахування. За розбіжності зафіксуйте обидва набори даних і відкрийте випадок для звірки. Зберігайте ідентифікатори протягом періодів відновлення й повторної обробки, які підтримує ваша інтеграція. Після тайм-ауту з невідомим результатом повторіть операцію з тим самим ключем. Якщо перша спроба завершилася, повтор знайде її запис. Якщо транзакцію відкотили, зарахування можна виконати після перевірки.

Так само обробляйте сповіщення, що надійшли в іншому порядку. Якщо підтвердження надійшло раніше за сповіщення про виявлення, прочитайте актуальні записи й зарахуйте кошти після всіх перевірок. Пізнє сповіщення може запустити повторне читання, а попереднє зарахування залишиться в історії. Якщо нові дані суперечать попередньому обліковому ефекту, збережіть актуальні докази та застосуйте процедуру коригування за контрактом і правилами обліку. Збережіть початковий запис про зарахування, щоб фінансова команда могла пояснити коригування. Звірка BroSettlement

Відновлення після розриву WebSocket

Після розриву з’єднання запустіть звірку. Якщо відновлення перервалося, поверніться до незавершеної роботи. За підтримки у вашому середовищі перепідключіться до /v1/ws із дозволом websockets:read, щоб відновити приймання поточних подій. Пропуски відновлюйте через читання транзакцій і журналу. Це охоплює відомі депозити й ті, про які застосунок не отримав сповіщення. Можливості потоку звірте з чинним контрактом. Події WebSocket · Звірка BroSettlement

Перечитайте відомі операції. Отримайте актуальний запис кожного незавершеного депозиту за ID, включно зі створеними до розриву. Прочитайте записи журналу відповідного гаманця за фільтром transactionId. Зіставте їх із записами про застосовані зарахування. Раніше створений депозит може підтвердитися під час розриву, а вже підтверджений може отримати проведений запис, поки з’єднання відсутнє. Тримайте операцію відкритою, доки не виконано умови зарахування або оператор не вирішив розбіжність.

Знайдіть пропущені депозити. Використайте курсорний GET /api/v1/transactions із дозволом transactions:read. Почніть із type=DEPOSIT і значень chain та asset за контрактом. За потреби звузьте вибірку за accountId або walletId. Задайте createdFrom і createdTo для вікна, яке частково перекривається з попереднім завершеним проходом. Ці фільтри стосуються часу створення запису. Зміни стану старіших депозитів під час розриву охоплює перевірка відомих ID.

Пройдіть за курсором усі сторінки у вікні й передайте кожен знайдений депозит на ті самі перевірки транзакції, журналу та доступності, що й під час приймання подій. Збережіть очікувані депозити для наступної звірки. Пересувайте збережену межу пошуку після опрацювання всіх сторінок або надійної постановки решти роботи в чергу. Після часткового збою продовжте за збереженим станом або повторіть прохід із перекриттям. Спільний ключ зарахування дає змогу знову отримати вже застосований запис, поки триває пошук решти депозитів.

Збій або прогалинаДія під час відновленняОчікуваний результат в обліку
З’єднання розірвалося до першого сповіщення про депозитЗнайти депозит курсорним пошуком із перекриттям і прочитати транзакцію та журнал.Зарахувати придатний проведений запис один раз. Залишити очікуваний депозит на контролі.
Відомий депозит підтвердився під час розривуПеречитати транзакцію за ID та записи журналу, навіть якщо депозит створено раніше за вікно пошуку.Зарахувати кошти після перевірки запису й умов доступності.
Депозит підтверджено, а придатного проведеного запису ще немаєЗалишити операцію відкритою та повторити читання журналу за правилами інтеграції.Доступні кошти залишаються без змін до появи облікового підтвердження.
Поточна подія та звірка знаходять той самий проведений записВикористати спільну операцію зарахування й унікальний ключ запису журналу.Обліковий ефект фіксується один раз.
Дані гаманця, активу чи суми розходяться з локальними записамиЗберегти ідентифікатори транзакції та запису журналу й передати розбіжність на перевірку.Початкові облікові докази доступні для перевірки. Нове зарахування не виконується, доки випадок відкритий.

Наприкінці проходу зіставте придатні проведені записи з локальними зарахуваннями в межах того самого середовища, гаманця, прив’язки до клієнта й активу. Звірте вплив депозитів на баланс застосунку з урахуванням інших змін балансу. Збережіть вікно пошуку, оброблені сторінки або роботу, надійно поставлену в чергу, незавершені ID та розбіжності. Після повторного переривання оператор побачить, які сторінки вже пройдено та які депозити потребують перевірки.

Після розриву WebSocket відомі ID депозитів і курсорний пошук пропущених депозитів у вікні з перекриттям ведуть до спільної перевірки транзакцій та журналу. Придатні записи зараховують один раз, розбіжності передають на розгляд.

Перевірка депозитного процесу перед запуском

Підготуйте активовану тестову конфігурацію за відповідним контрактом. Виберіть контрольну суму й клієнтський рахунок із відомим початковим балансом. Для кожного сценарію зафіксуйте подію або змодельований розрив, стан транзакції, відповідний запис журналу, локальний запис про застосування та доступний баланс до і після обробки.

  1. Типовий депозит. Перекажіть USDT у мережі TRON на призначену адресу. Якщо продукт показує очікувані кошти, перевірте, що депозит видно в цьому стані, а доступний баланс поки без змін. Після перевірки транзакції, проведення й доступності має з’явитися один запис про застосування та одне поповнення на належну суму.
  2. Повтор сповіщення. Обробіть те саме сповіщення повторно й знайдіть депозит під час звірки. Перевірте, що запис журналу зіставився з початковим зарахуванням і баланс залишився узгодженим.
  3. Одночасна обробка. Дайте двом обробникам одночасно дійти до одного придатного запису. Очікуйте один зафіксований обліковий ефект. Повторіть після тайм-ауту з невідомим результатом і перевірте, що кошти стали доступними один раз.
  4. Порушений порядок подій. Передайте сповіщення про підтвердження, а потім раніше сформоване сповіщення про виявлення. Обидва мають запускати читання актуального стану. Пізня доставка має зберегти результат зарахування. Повторіть із затримкою проведення запису й переконайтеся, що кошти лишаються недоступними до перевірки журналу й правил доступності.
  5. Розрив WebSocket. Перервіть приймання до першого сповіщення про один депозит, коли інший, уже відомий, ще очікує. Нехай обидва виконають умови зарахування під час розриву. Перший має знайти курсорний пошук, другий — перевірка відомого ID. Після повторного запуску звірки для кожного зарахування має бути один запис про застосування.
  6. Розбіжність прив’язки або суми. Створіть контрольну розбіжність між записами провайдера й локальною прив’язкою або потенційним зарахуванням. Перевірте, що доступний баланс за цією операцією не змінився, а оператор може відтворити рішення за збереженими ідентифікаторами й сумами.

Перед запуском звірте критерій фінальності TRON USDT, умови витрачання або виведення зарахованих коштів, порядок коригувань і доступні можливості WebSocket. Перевірте, що облікові дані для читання відкривають доступ до потрібних транзакцій і журналів гаманців. Зафіксуйте версію контракту, результати тестів і відповідального за невирішені розбіжності. Довідник BroSettlement API · Операційний журнал · Звірка BroSettlement

Поширені запитання

Що має робити застосунок після deposit.observed?

Заплануйте читання актуальної транзакції та звірте адресу отримання зі збереженою прив’язкою. Залиште депозит в очікуванні до підтвердження, проведення запису й перевірки доступності. Робіть кошти доступними після виконання всіх застосовних умов.

Що робити, якщо транзакція CONFIRMED, а кредитового запису ще немає?

Залиште операцію відкритою та повторіть читання журналу гаманця за transactionId. Якщо запис не з’явився у строк, визначений правилами інтеграції, відкрийте випадок для звірки з ідентифікаторами транзакції й гаманця.

Який ідентифікатор захищає від повторного зарахування?

Використовуйте стабільний ідентифікатор відповідного запису журналу в межах унікальності, визначених контрактом. Ідентифікатор події використовуйте для розпізнавання повторних сповіщень. Ідентифікатор запису дає змогу різним подіям і звірці застосувати один обліковий ефект.

Чому обидва сповіщення мають запускати читання актуальної транзакції?

Вони повідомляють про різні етапи обробки й можуть надійти в іншому порядку. Повторне читання показує поточний стан транзакції. Далі звірте проведення в журналі й перевірте доступність, перш ніж зарахувати кошти.

Як знайти депозит, створений до розриву з’єднання?

Перечитайте відомі незавершені транзакції за ID та перевірте їхні записи журналу. Курсорний пошук допомагає знайти записи, створені в межах заданого вікна. Продовжуйте відстежувати відомі старіші депозити, оскільки їхній стан може змінитися під час розриву.

Скільки підтверджень TRON потрібно перед зарахуванням?

Застосовуйте критерій із чинного контракту інтеграції. Звірте, як він пов’язаний зі станом транзакції та моментом, коли продукт дозволяє витратити або вивести зараховані кошти.

Що робити, якщо нове читання суперечить попередньому зарахуванню?

Збережіть початковий запис про зарахування, зберіть актуальні дані транзакції й журналу та відкрийте випадок для звірки. Для коригування використайте механізм, визначений контрактом і вашими правилами обліку.

CEO та засновник BroLabel

Колишній керівник продукту та CEO криптобіржі. Будує системи гаманців, підписання й операційного журналу для криптопродуктів.

Інтеграція депозитів USDT у мережі TRON із BroSettlement