Get Deposit Source Address

GET /v1/wallet/deposit-whitelist/addresses/{id}

The payer's source address must be registered and reviewed before the deposit can reach the
available balance of the receiving wallet. See the guide: Guides · Wallet · Deposit whitelist.

Returns one source-address record together with the deposits received from that address.

Read status to decide what to do next:

`status`	Meaning	Next step
`PROCESSING`	Under review	Wait for `WALLET_ADDRESS_UPDATED`, or poll
`ACTIVE`	Approved	Nothing. Later deposits from this address skip the whitelist flow — no `DEPOSIT_WHITELIST_*` webhook at all, only `DEPOSIT_ORDER_NOTIFICATION`
`FAILED`	Rejected	Call `POST /v1/wallet/deposit-whitelist/addresses/{id}/disable`, then register a new record

A record is never editable. Correcting details always means disable + register again.

Error codes

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

`code`	Meaning
`10000100`	Transaction not found, or it does not belong to the caller
`10000101`	Deposit-whitelist review already completed for this deposit
`10000102`	Payer details incomplete
`10000103`	Field value not accepted, including an invalid `countryCode` or an unknown `provider`
`10000104`	Cannot submit right now — poll the status instead of editing and retrying immediately
`10000105`	Duplicate request
`10000106`	Source address cannot be supplied or changed when submitting for a received deposit

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": 200,
  "code": null,
  "msg": "OK",
  "traceId": "Auto:bf288b9af2e04dff88e943f2dcaf2b03",
  "data": {
    "id": "10001",
    "walletLabel": "Payport Limited",
    "walletAddress": "0x3a1F8C4e2b6C8c9D7fE2B8b5a1d3C9A0bE12F345",
    "network": "BSC",
    "memo": "",
    "symbol": "USDC",
    "addressType": "STANDARD",
    "walletType": "VASP",
    "provider": "Binance",
    "othersPleaseSpecify": null,
    "correspondentType": "ENTITY",
    "fullName": "Payport Limited",
    "firstName": null,
    "lastName": null,
    "countryCode": "SG",
    "status": "ACTIVE",
    "failMessage": "",
    "addedAt": "2026-09-04T08:30:00Z",
    "createTime": "2026-09-04T08:12:00Z",
    "deposits": [
      {
        "transactionId": "20573580428712136704",
        "amount": "100.00",
        "currency": "USDC",
        "network": "BSC",
        "txHash": "0x9c1a...f3",
        "walletId": "123",
        "status": "SUCCESS",
        "whiteListStatus": "approved",
        "creditStatus": "CREDITED",
        "createTime": "2026-09-04T08:12:00Z"
      }
    ]
  }
}

Get Deposit Source Address