banking.v1.BalanceService

RecordDeposit

Record a settled on-chain deposit, crediting a party's claim. Idempotent by tx_ref — recording the same chain tx twice credits once.

post/banking.v1.BalanceService/RecordDeposit

Request

  • The document declares no server URL.
  • Auth: none required

Headers

Connect-Protocol-Version1 required

Define the version of the Connect protocol

Connect-Timeout-Msnumber

Define the timeout, in ms

Request body

tx_refstring

txhash:logIndex (EVM) | txhash:recipient (TON) — verified, and the idempotency key

networkstring

bep20 | polygon | trc20 | ton — the rail it arrived on

expected_amountstring

Optional operator assertion in decimal USDT. When set it must equal what the chain reports or the call is refused, so a mistyped reference fails loudly instead of silently crediting some other transfer.

Response

Success

recordedboolean

false if tx_ref was already recorded (idempotent no-op)

amountstring

what the CHAIN reported, decimal USDT — never the caller's number

party_kindstring

always user

party_idstring

the banking user id

Changes

Changes to this operation have not been checked yet.