Update Sub-wallet Payer Profile

PUT /v1/wallet/deposit-whitelist/wallets/{walletId}/profile

Replaces the payer details stored against this sub-wallet. Send the complete payer object; this is a replace, not a patch.

Replacing the profile does not re-open source addresses that are already ACTIVE, and it does not retroactively fix a deposit that was already rejected. Deposits sitting at init or rejected are still handled with POST /v1/wallet/deposit-whitelist/transactions/{transactionId}/submit. The new details apply to deposits that arrive afterwards.

A profile cannot be deleted, only replaced.

Payer fields

`correspondentType`	Mandatory	Must NOT be sent
`ENTITY`	`fullName`, `countryCode`, `companyAddress`	`firstName`, `lastName`, `birthday`, `residentialAddress`
`INDIVIDUAL`	`firstName`, `lastName`, `birthday` (`yyyy-MM-dd`), `countryCode`, `residentialAddress`	`fullName`

`walletType`	Also mandatory
`VASP`	`provider` — a `name` from `GET /v1/wallet/deposit-whitelist/options`
`OTHERS`	`othersPleaseSpecify`, max 255 characters
`SELF_HOSTED`	—

countryCode is an ISO 3166-1 alpha-2 code such as SG. Do not send countryInfo.

Errors

`code`	Meaning
`10000102`	Payer details incomplete for the given `correspondentType`
`10000103`	Field value not accepted, including an invalid `countryCode` or unknown `provider`
`10000105`	Duplicate request
`10000107`	Wallet invalid, or the sub-wallet has not been created

Guide: Wallet · Deposit whitelist

Request

Authorization

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: ********************

Path Params

Header Params

Body Params application/json

Example

{
    "requestId": "b0f4c6a2-7d51-4c0e-9a2f-6f7c1e2d3b40",
    "walletLabel": "Payport Limited",
    "walletType": "VASP",
    "provider": "Binance",
    "othersPleaseSpecify": "",
    "correspondentType": "ENTITY",
    "fullName": "Payport Limited",
    "firstName": "Alex",
    "lastName": "Tan",
    "birthday": "1990-01-31",
    "countryCode": "SG",
    "companyAddress": "Tampines Blk67, Singapore",
    "residentialAddress": "12 Bedok North Ave 4, Singapore"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Bodyapplication/json

Examples

Success — replacedFailure — sub-wallet does not exist

{
  "status": 200,
  "code": null,
  "msg": "OK",
  "traceId": "Auto:bf288b9af2e04dff88e943f2dcaf2b03",
  "data": {
    "walletId": "3095",
    "walletLabel": "Payport Holdings",
    "walletType": "VASP",
    "provider": "Binance",
    "othersPleaseSpecify": null,
    "correspondentType": "ENTITY",
    "fullName": "Payport Holdings Limited",
    "firstName": null,
    "lastName": null,
    "birthday": null,
    "countryCode": "SG",
    "companyAddress": "Tampines Blk67, Singapore",
    "residentialAddress": null,
    "createTime": "2026-09-08T09:12:00Z",
    "updateTime": "2026-09-09T02:31:00Z"
  }
}

Update Sub-wallet Payer Profile