Update Merchant
This endpoint is for merchants with a Partner account. To activate a Partner account, contact us.
Update an existing merchant's information under your Partner account. Use this to modify company details, address, bank account information, and business details.
When to Use
▾
Use this endpoint when:
- A merchant needs to update their company information
- Business details such as address or contact information change
- Bank account or settlement information needs to be updated
How to Use
▾
/v3/partner/merchant/{merchantId}Step 1: Get the Merchant ID
▾
Locate the merchantID for the merchant you want to update. You can get this from the Get Merchants endpoint.
Step 2: Prepare the Updated Data
▾
Gather the fields you want to update. Only include the fields that need to be changed — all fields are optional.
Step 3: Make the PATCH Request
▾
Send the updated merchant information with the merchantID as a path parameter.
Step 4: Review the Response
▾
Check the code field. If "SUCCESS", the merchant was updated. The full merchant object is returned.
Request Parameters
▾
Pass the merchant ID as a path parameter in the URL.
Example: "Revenue Monster"
Example: "https://revenuemonster.my"
Example: "XAS1233123"
Example: "2006-01-02T15:04:05Z"
Example: "1, Jalan Pertanian 25"
Example: "Taman Universiti"
Example: "81300"
Example: "SKUDAI"
Example: "JOHOR"
Example: "MALAYSIA"
Example: "60"
Example: "187824152"
Example: "Revenue Monster"
Example: "PRIVATE LIMITED COMPANY (SDN BHD)"
Example: "COMPUTER AND ELECTRONICS"
Example: 1000000
Example: 1000000
Example: "some business scope"
Invoice address
Address line 1
Example: "1, Jalan Pertanian 25"
Address line 2
Example: "Taman Universiti"
Postcode
Example: "81300"
City
Example: "SKUDAI"
State
Example: "JOHOR"
Country
Example: "MALAYSIA"
Supporting document URLs
Example: "https://somefileendpoint.com"
Example: "https://somefileendpoint.com"
Example: "https://somefileendpoint.com"
Example: "https://somefileendpoint.com"
Example: "https://somefileendpoint.com"
Example: "https://somefileendpoint.com"
Example: "https://somefileendpoint.com"
Example: "https://somefileendpoint.com"
Example: "https://somefileendpoint.com"
Example: "https://somefileendpoint.com"
Example: "https://somefileendpoint.com"
Example: "https://somefileendpoint.com"
List of persons to inspect
Example: "NG SZE CHEN"
Example: "MALE"
Example: "1999-07-14T15:59:59Z"
Example: "MALAYSIAN"
Example: "IC"
Example: "2131290134"
Example: "CORPORATE"
Example: "Revenue Monster"
Example: "32312323"
Example: "HLBB"
Example: 0.0
Example: 0.0
Example: "BOTH"
Example: false
Example: false
Example: false
Response Parameters
▾
The updated settlement record.
Settlement ID
Example: "1629258558902992793"
Merchant ID
Example: "1629258448138509563"
Whether this is the default settlement account
Example: true
Company name of merchant
Example: "REVENUE MONSTER"
Type of company incorporation
Example: "PRIVATE LIMITED COMPANY (SDN BHD)"
Registration number of merchant
Example: "12344"
Business category of merchant
Example: "SOFTWARE AND IT"
Business scope of merchant
Example: "some business scope"
Source of funds of merchant
Example: ""
Customer origin of merchant
Example: ""
Established date time of merchant
Example: "2006-01-02T15:04:05Z"
Country code of merchant contact number
Example: "60"
Phone number of merchant
Example: "187824152"
Address 1 of merchant
Example: "1, Jalan Pertanian 25"
Address 2 of merchant
Example: "Taman Universiti"
Postcode of merchant
Example: "81300"
City of merchant
Example: "SKUDAI"
State of merchant
Example: "JOHOR"
Country of merchant
Example: "MALAYSIA"
Example: false
Invoice address
Address line 1
Example: "1, Jalan Pertanian 25"
Address line 2
Example: "Taman Universiti"
Postcode
Example: "81300"
City
Example: "SKUDAI"
State
Example: "JOHOR"
Country
Example: "MALAYSIA"
List of persons to inspect
Example: "NG SZE CHEN"
Example: ""
Example: ""
Example: "60"
Example: ""
Example: "MALE"
Example: "1999-07-14T15:59:59Z"
Example: "MALAYSIAN"
Example: "IC"
Example: "2131290134"
Example: ""
Example: ""
Current status of settlement
Example: "UNVERIFIED"
Supporting document URLs
Example: "https://somefileendpoint.com"
Example: "https://somefileendpoint.com"
Example: "https://somefileendpoint.com"
Example: "https://somefileendpoint.com"
Example: "https://somefileendpoint.com"
Example: "https://somefileendpoint.com"
Example: "https://somefileendpoint.com"
Example: "https://somefileendpoint.com"
Example: "https://somefileendpoint.com"
Example: "https://somefileendpoint.com"
Example: "https://somefileendpoint.com"
Example: "https://somefileendpoint.com"
Example: ""
Example: ""
Example: ""
Example: ""
Example: ""
Uploaded document file URLs
Example: null
Example: null
Example: null
Example: null
Example: null
Example: null
Example: null
Example: null
Example: null
Example: null
Example: null
Example: null
Example: "32312323"
Example: "CORPORATE"
Example: "Revenue Monster"
Example: "HONG LEONG BANK"
Example: "HLBB"
Example: 0
Example: 0
Example: ""
Agent commission rate
Example: 0
Creation date time of settlement
Example: "2021-06-02T14:37:25+08:00"
Last update date time of settlement
Example: "2021-06-02T14:37:25+08:00"
Tax registration details
Tax identification number
Example: ""
SST registration number
Example: ""
Tourism tax registration number
Example: ""
Malaysia Standard Industrial Classification code
Example: ""
Whether tax info has been submitted
Example: false
Email addresses that receive settlement notifications
Example: null
"SUCCESS" if the call succeeded. Otherwise returns an error code object. See Appendix 1: Error Codes.
Example: "SUCCESS"