Yedpay

Description (Update Beneficial Owner)

Update the selected Beneficial Owner. (PUT)

End Point

https://api.yedpay.com/v1/beneficial-owners/{{beneficial_owner_id}}

Variable

# Name Type Description
1 beneficial_owner_id String Beneficial Owner ID

Request Header

# Key Value Description
1 Authorization Bearer {{access_token}} Login Token

Body

# Name Type Description
1 legal_name String Legal name of the beneficial owner
(Not applicable for owner with user account i.e. user_id present)
2 date_of_birth Date Date of birth of the beneficial owner (format: YYYY-mm-dd)
3 proof_of_identity String Proof of identity of the beneficial owner (HKID/Passport number)
4 nationality String Nationality of the beneficial owner
5 percentage_owned decimal Percentage of benefit owned by the owner (Range: 25 - 100)

Response

# Name Type Description
1 success Boolean Update Beneficial Owner Success or Fail
2 data Array Beneficial Owner Data (present if success)
3 message String Message (present if fail)
4 status Array Status code(optional)

Success Response - data

# Name Type Description
1 id String Id of the beneficial owner
2 company_id String Id of beneficial owner's company
3 user_id String Id of beneficial owner's user account
4 legal_name String Legal name of the beneficial owner
5 date_of_birth Date Date of birth of the beneficial owner (format: YYYY-mm-dd)
6 proof_of_identity String Proof of identity of the beneficial owner (HKID/Passport number)
7 nationality String Nationality of the beneficial owner
8 percentage_owned Float Percentage of benefit owned by the owner

Example Success Response

            {
                "success": true,
                "data": {
                    "id": "6M7V578",
                    "company_id": "6M7V578",
                    "user_id": "",
                    "legal_name": "Xxxxx Xxxx",
                    "date_of_birth": "2018-01-01",
                    "proof_of_identity": "T123123(0)",
                    "percentage_owned": 25,
                    "nationality": "Hong Kong"
                }
            }
        

Example Error Response

            {
                "success": false,
                "message": "Unauthenticated.",
                "status": 500
            }
        

v1.19.0-20190522 © The Payment Cards Group Limited. All rights reserved.