Get Wallet Transaction Detail

Returns one wallet transaction in the authenticated merchant user's scope. Supply requestId or transactionId; when both are supplied, they are combined with AND.

Deposit whitelist

Deposit records also carry whiteListStatus and creditStatus.

Three independent states travel together — do not collapse them:

Field	Answers
`status`	Is the whole deposit finished?
`whiteListStatus`	Where is the Travel Rule review?
`creditStatus`	Is the money spendable?

Read creditStatus, not status, to decide whether the funds can be used.

`status`	`whiteListStatus`	`creditStatus`	Meaning
`PROCESSING`	`init`	`PENDING`	Waiting for you to submit payer details
`PROCESSING`	`pending`	`PENDING`	Under review. Funds in the unavailable balance
`PROCESSING`	`rejected`	`PENDING`	Rejected — resubmit. Funds still unavailable
`PROCESSING`	`approved`	`CREDITED`	Normal. Funds already available; the deposit itself is not finished (auto-collection still running, for example)
`SUCCESS`	`approved`	`CREDITED`	Deposit fully complete, including auto-collection where enabled
any	any	`BLOCKED`	Could not be credited — contact support

whiteListStatus replaces the withdrawn submitStatus, and its values are lowercase
(init / pending / approved / rejected). Non-deposit transactions may return null for both
fields, or omit them.

Submit payer details with POST /v1/wallet/deposit-whitelist/transactions/{transactionId}/submit.

Guide: Wallet · Deposit whitelist

Error codes

Business failures return status 500 and an 8-digit code (WalletErrorCode).

`code`	Meaning
`10000046`	Neither `requestId` nor `transactionId` was supplied
`10000007`	No transaction in this merchant user's scope matches the supplied identifiers

API Key

Add parameter in header

API-KEY

Example:

API-KEY: ********************

API Key

Add parameter in header

API-SIGNATURE

Example:

API-SIGNATURE: ********************

API Key

Add parameter in header

API-TIMESTAMP

Example:

API-TIMESTAMP: ********************

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Bodyapplication/json

Example

{
    "status": 0,
    "code": "string",
    "msg": "string",
    "traceId": "string",
    "success": true,
    "data": {
        "transactionId": "20573580428712136704",
        "requestId": "b0f4c6a2-7d51-4c0e-9a2f-6f7a1c2d3e45",
        "walletId": 123,
        "transactionType": "DEPOSIT",
        "status": "PROCESSING",
        "whiteListStatus": "init",
        "creditStatus": "PENDING",
        "failMessage": "",
        "currency": "USDC",
        "amount": "100.00",
        "fee": "0.50",
        "network": "BSC",
        "fromAddress": "0x3a1F8C4e2b6C8c9D7fE2B8b5a1d3C9A0bE12F345",
        "toAddress": "0x9dE4a1B7c2F80e5A3b6C1d9E7f0A2b4C6d8E0F13",
        "memo": "",
        "blockchainHash": "0x9c1a...f3",
        "createTime": "2026-09-08T09:12:00Z",
        "completeTime": ""
    }
}

Get Wallet Transaction Detail

Deposit whitelist#

Error codes#

Request

Request Code Samples

Responses

Deposit whitelist

Error codes