Shared Types
Requests And Response Types
Decimal
Fixed-point monetary amount: unscaled * 10^exponent, so 123.45 is
unscaled=12345, exponent=-2. Local to the pay contract — pay is an
independent service and deliberately shares no types with tzero.v1.common,
so a participant’s generated code carries exactly one Decimal and one
Blockchain.
| Field | Type | Label | Description |
|---|---|---|---|
| unscaled | int64 | ||
| exponent | int32 |
OnChainSettlementDetails
USDt-on-chain settlement payload, shared by the issuer’s SettlementSent and the acquirer’s SettlementCompleted usdt variant.
| Field | Type | Label | Description |
|---|---|---|---|
| on_chain_tx_hash | string | Hash of the settlement transaction. | |
| chain | Blockchain | Chain the settlement moved over. | |
| destination_address | string | Registered settlement wallet on chain — the Acquirer’s (USDt mode) or the LP’s (fiat mode). |
QrOption
One selectable QR payment option for an intent — the renderable payload is chain-native and encoded by the POS without modification.
| Field | Type | Label | Description |
|---|---|---|---|
| chain | Blockchain | Chain this deposit option pays on. | |
| deposit_address | string | One-time deposit address reserved for this intent on chain. | |
| renderable_payload | string | Chain-native URI (e.g. ERC-681 on EVM) the POS encodes as a QR image as-is. |
UsdtOnChainPayment
One on-chain USDt transfer made by the customer. The only payment-method variant in the MVP.
| Field | Type | Label | Description |
|---|---|---|---|
| chain | Blockchain | Chain the customer’s USDt transfer moved over. | |
| on_chain_tx_hash | string | Hash of the customer’s USDt transfer. | |
| sender_address | string | Customer’s source wallet address, for receipt and audit. |
Blockchain
On-chain network a USDt leg moves over. Local to the pay contract, which is
an independent service and shares no types with tzero.v1.common.
Launch-live: TRON, ETH, BSC. Six more (Polygon, Arbitrum, Optimism, Base,
Avalanche, Solana) are announced as upcoming and added here as they go live.
| Name | Number | Description |
|---|---|---|
| BLOCKCHAIN_UNSPECIFIED | 0 | |
| BLOCKCHAIN_TRON | 10 | |
| BLOCKCHAIN_ETH | 20 | |
| BLOCKCHAIN_BSC | 30 |