Beneficiary Query

POST

/v1/channel/beneficiary/query

Query beneficiary information.Returns the beneficiary associated with the provided Beneficiary ID

Request

Body Params application/json

Example

{
    "merchantId": "445684d438564efea3b92a8d674d5516",
    "beneficiaryId": "31d961772b964b489ff63bbed6306609"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v1/channel/beneficiary/query' \
--header 'Content-Type: application/json' \
--data-raw '{
    "merchantId": "445684d438564efea3b92a8d674d5516",
    "beneficiaryId": "31d961772b964b489ff63bbed6306609"
}'

Responses

🟢200

application/json

Body

Example

{
    "merchantId": "445684d438564efea3b92a8d674d5516",
    "beneficiaryId": "31d961772b964b489ff63bbed6306609",
    "type": "ENTERPRISE",
    "bankName": "HSBC Hong Kong",
    "bankAccount": "808-123456-001",
    "currency": "USD",
    "branchName": "HSBC Main Branch Central",
    "bankCountry": "HK",
    "bankAddress": "1 Queen's Road Central, Hong Kong",
    "routingType": "swift",
    "routingCode": "HSBCHKHHHKH",
    "payeeName": "HONG KONG TECHNOLOGY LTD",
    "payeeCountry": "HK",
    "payeeCity": "Hong Kong",
    "payeeAddress": "Unit 1501, 15/F, Central Plaza, 18 Harbour Road, Wan Chai",
    "payeePostalCode": "999077",
    "remark": null,
    "status": "SUCCESS"
}

Modified at 2025-12-22 05:38:57

Beneficiary Update

Beneficiary Delete