Deposits

A deposit is an on-chain payment ZaroPay detected to one of your addresses. Always scoped to the authenticated merchant.

List GET /v1/deposits

Query params:

Param	Type	Notes
status	string	DETECTED, CONFIRMING, CONFIRMED, STUCK, REORG_PENDING, FAILED
statusGroup	string	confirmed · pending (DETECTED+CONFIRMING) · failed (FAILED+STUCK+REORG_PENDING)
chain	string	tron
walletId	string (uuid)	Filter by settlement account
q	string	Search over tx_hash, to_address, amount, id (max 120)
page / limit	int	1–100, default 20

Returns an array of deposit rows + meta, newest first.

Retrieve GET /v1/deposits/:id

:id is the deposit UUID (404 if not yours).

Deposit fields

Field	Type	Notes
id	string (uuid)
merchant_id	string (uuid)
deposit_address_id	string (uuid) | null
chain / currency	string
tx_hash	string	On-chain transaction hash
output_index	int	Log/output index within the tx
amount	string	On-chain gross received (decimal string, full precision)
amount_units	string | null	Raw base units
from_address	string | null	Payer
to_address	string	Your deposit address
block_number	bigint | null
confirmations	int
required_confirmations	int
status	string	Deposit status enum
expected_amount	string | null	Order amount, if any
fee_mode	string | null	merchant / client
payment_state	string | null	exact, underpaid, overpaid
settlement_account_id	string (uuid) | null
api_key_id	string (uuid) | null	Which key created the originating address
recovered_at	timestamp | null	Set only for late-payment recovery (null = on-time)
detected_at / confirmed_at	timestamp | null
created_at / updated_at	timestamp

Amounts here are un-normalized

On this raw deposit row, decimal amounts may appear as full-scale strings (e.g. "100.000000000000000000"). The webhook payload gives you cleaned-up amount / grossAmount / orderAmount strings — prefer those for display and reconciliation.