Merchant Info

Retrieve detailed information about a specific merchant under your Partner account, including merchant details, settlement information, and document status.

When to Use

▾

Use this endpoint when you:

Need to view a specific merchant's complete details
Want to check the merchant's settlement or document status
Need to verify merchant information for support tickets

note

This endpoint is for merchants with a Partner account. To activate a Partner account, contact us.

How to Use

▾

Endpoint

GET/v3/partner/merchant/{merchantId}

Step 1: Get the Merchant ID

▾

Locate the merchantID for the merchant you want to retrieve. You can get this from the Get Merchants endpoint.

Step 2: Make the GET Request

▾

Include the merchantID as a path parameter in the URL.

Step 3: Review the Response

▾

The response contains merchant and settlement objects with complete details.

Request Parameters

▾

merchantIDSTRINGrequired

The unique ID of the merchant to retrieve

Example: "1629258448138509563"

Response Parameters

▾

itemOBJECT

Contains merchant and settlement objects

merchantOBJECT

Merchant details

idSTRING

Unique merchant ID

Example: "6170506694335521334"

companyNameSTRING

Registered company name

Example: "REVENUE MONSTER"

brandNameSTRING

Brand name if different from company

Example: ""

shortNameSTRING

Short name / alias for the merchant

Example: ""

companyTypeSTRING

Type of company incorporation

Example: "SOLE PROPRIETOR"

companyLogoUrlSTRING

Public URL for company logo

Example: "https://storage.googleapis.com/rm-sandbox-asset/img/merchant.png"

registrationNumberSTRING

Company registration number

Example: ""

businessCategorySTRING

Business category

Example: ""

businessScopeSTRING

Scope of business activities

Example: ""

sourceOfFundsSTRING

Source of the merchant's funds

Example: ""

customerOriginSTRING

Origin/channel of the merchant's customers

Example: ""

websiteUrlSTRING

Merchant's website URL

Example: ""

establishedAtDATETIME

Established date time of the company

Example: "0001-01-01T00:00:00Z"

countryCodeSTRING

Country code for contact

Example: "60"

phoneNumberSTRING

Contact phone number

Example: "377334080"

addressLine1STRING

Street address line 1

Example: ""

addressLine2STRING

Street address line 2

Example: ""

postcodeSTRING

Postal/ZIP code

Example: ""

citySTRING

City

Example: ""

stateSTRING

State/Province

Example: ""

countrySTRING

Country

Example: ""

invoiceAddressOBJECT

Merchant's invoice/billing address

addressLine1STRING

Invoice address line 1

Example: ""

addressLine2STRING

Invoice address line 2

Example: ""

postcodeSTRING

Invoice address postcode

Example: ""

citySTRING

Invoice address city

Example: ""

stateSTRING

Invoice address state

Example: ""

countrySTRING

Invoice address country

Example: ""

isActiveBOOLEAN

Whether the merchant account is active

Example: true

statusSTRING

Current status ("REVIEWING", "UNVERIFIED", "ACTIVE")

Example: "REVIEWING"

isMasterMerchantBOOLEAN

Whether this merchant is a master merchant

Example: false

masterMerchantIdSTRING

Master merchant ID, if any

Example: ""

isPartnerBOOLEAN

Whether this is a partner merchant

Example: true

partnerIdSTRING

Partner ID if applicable

Example: ""

gstNoSTRING

GST registration number

Example: ""

paymentSubscriptionSTRING

Payment subscription plan

Example: ""

subscriptionOBJECT

Subscription flags

terminalOfflineEWalletBOOLEAN

Offline e-wallet terminal enabled

Example: false

terminalOfflineCreditCardBOOLEAN

Offline credit card terminal enabled

Example: false

onlineCreditCardBOOLEAN

Online credit card enabled

Example: false

onlineCreditCardWhitelistCountriesARRAY

Countries whitelisted for online credit card payment

Example: []

partialRefundBOOLEAN

Partial refund enabled

Example: false

smsOpenApiBOOLEAN

SMS Open API enabled

Example: false

recurringPaymentsBOOLEAN

Recurring payments enabled

Example: false

tokenizedPaymentsBOOLEAN

Tokenized payments enabled

Example: false

merchantWalletBOOLEAN

Merchant wallet enabled

Example: false

vopApiBOOLEAN

VOP API enabled

Example: false

registrationSourceSTRING

How the merchant was registered

Example: "OPEN_API"

createdAtDATETIME

Account creation timestamp

Example: "2021-08-18T03:47:28Z"

updatedAtDATETIME

Last update timestamp

Example: "2021-08-18T03:47:28Z"

settlementOBJECT

Settlement details

idSTRING

Unique settlement ID

Example: "1629258558902992793"

merchantIdSTRING

Associated merchant ID

Example: "1629258448138509563"

isDefaultBOOLEAN

Whether this is the default settlement account

Example: true

companyNameSTRING

Company name

Example: "REVENUE MONSTER"

companyTypeSTRING

Type of company incorporation

Example: "SOLE PROPRIETOR"

registrationNumberSTRING

Company registration number

Example: ""

businessCategorySTRING

Business category

Example: ""

businessScopeSTRING

Scope of business activities

Example: ""

sourceOfFundsSTRING

Source of the merchant's funds

Example: ""

customerOriginSTRING

Origin/channel of the merchant's customers

Example: ""

establishedAtDATETIME

Established date time of the company

Example: "0001-01-01T00:00:00Z"

countryCodeSTRING

Country code for contact

Example: "60"

phoneNumberSTRING

Contact phone number

Example: "377334080"

addressLine1STRING

Street address line 1

Example: ""

addressLine2STRING

Street address line 2

Example: ""

postcodeSTRING

Postal/ZIP code

Example: ""

citySTRING

City

Example: ""

stateSTRING

State/Province

Example: ""

countrySTRING

Country

Example: "Malaysia"

isSameBusinessAddressBOOLEAN

Whether settlement address matches business address

Example: false

invoiceAddressOBJECT

Settlement's invoice/billing address

addressLine1STRING

Invoice address line 1

Example: ""

addressLine2STRING

Invoice address line 2

Example: ""

postcodeSTRING

Invoice address postcode

Example: ""

citySTRING

Invoice address city

Example: ""

stateSTRING

Invoice address state

Example: ""

countrySTRING

Invoice address country

Example: ""

inspectListARRAY

List of directors/shareholders submitted for KYC inspection

fullNameSTRING

Full name

Example: "John Doe"

emailSTRING

Email address

Example: ""

positionSTRING

Position/role in the company

Example: ""

countryCodeSTRING

Contact country code

Example: ""

phoneNumberSTRING

Contact phone number

Example: ""

genderSTRING

Gender

Example: "MALE"

birthdayDATETIME

Date of birth

Example: "2000-03-22T16:00:00Z"

nationalitySTRING

Nationality

Example: "MALAYSIAN"

idTypeSTRING

ID type

Example: "IC"

idNoSTRING

ID number

Example: "000322041234"

beginAtSTRING

Inspection start date time

Example: ""

endAtSTRING

Inspection end date time

Example: ""

statusSTRING

Settlement status ("REVIEWING", "ACTIVE")

Example: "REVIEWING"

documentOBJECT

Uploaded document URLs

ctosFileUrlSTRING

CTOS file URL

Example: ""

ownerICFileUrlSTRING

Owner IC file URL

Example: ""

directorICFileUrlSTRING

Director IC file URL

Example: ""

shareHolderICFileUrlSTRING

Shareholder IC file URL

Example: ""

businessRegistrationFileUrlSTRING

Business registration file URL

Example: ""

bankStatementFileUrlSTRING

Bank statement file URL

Example: ""

moaFileUrlSTRING

MOA file URL

Example: ""

form24FileUrlSTRING

Form 24 file URL

Example: ""

form49FileUrlSTRING

Form 49 file URL

Example: ""

section14FileUrlSTRING

Section 14 file URL

Example: ""

form44FileUrlSTRING

Form 44 file URL

Example: ""

businessSitePhotoFileUrlSTRING

Business site photo file URL

Example: ""

essmDocumentFileUrlSTRING

ESSM document file URL

Example: ""

letterOfConsentFileUrlSTRING

Letter of consent file URL

Example: ""

certificateOfRegistrationFileUrlSTRING

Certificate of registration file URL

Example: ""

meetingMinutesFileUrlSTRING

Meeting minutes file URL

Example: ""

organizationChartFileUrlSTRING

Organization chart file URL

Example: ""

documentFileOBJECT

Uploaded document file details

CTOSFileURLSTRING

CTOS file URL

Example: null

OwnerICFileURLSTRING

Owner IC file URL

Example: null

DirectorICFileURLSTRING

Director IC file URL

Example: null

ShareHolderICFileURLSTRING

Shareholder IC file URL

Example: null

BusinessRegistrationFileURLSTRING

Business registration file URL

Example: null

BankStatementFileURLSTRING

Bank statement file URL

Example: null

MOAFileURLSTRING

MOA file URL

Example: null

Form24FileURLSTRING

Form 24 file URL

Example: null

Form49FileURLSTRING

Form 49 file URL

Example: null

Section14FileURLSTRING

Section 14 file URL

Example: null

Form44FileURLSTRING

Form 44 file URL

Example: null

BusinessSitePhotoFileURLSTRING

Business site photo file URL

Example: null

bankAccountNoSTRING

Bank account number (masked)

Example: ""

bankAccountTypeSTRING

Bank account type

Example: ""

bankAccountHolderNameSTRING

Bank account holder name

Example: ""

bankNameSTRING

Bank name

Example: ""

bankCodeSTRING

Bank code

Example: ""

averageTicketSizeINTEGER

Average transaction ticket size

Example: 0

averageTurnoverPerMonthINTEGER

Average monthly turnover

Example: 0

paymentSubscriptionSTRING

Payment subscription plan

Example: ""

agentRateNUMBER

Agent commission rate

Example: 0

createdAtDATETIME

Creation timestamp

Example: "2021-08-18T04:03:15Z"

updatedAtDATETIME

Last update timestamp

Example: "2021-08-18T04:03:15Z"

taxInfoOBJECT

Tax registration details

tinSTRING

Tax identification number

Example: ""

sstRegNoSTRING

SST registration number

Example: ""

ttxRegNoSTRING

Tourism tax registration number

Example: ""

msicSTRING

Malaysia Standard Industrial Classification code

Example: ""

hasTaxInfoBOOLEAN

Whether tax info has been submitted

Example: false

notificationEmailsARRAY

Email addresses that receive settlement notifications

Example: []

codeSTRING

"SUCCESS" if the request succeeded. Otherwise returns an error code.

Example: "SUCCESS"

When to Use
How to Use
Request Parameters
Response Parameters

GETAPI Server/v3/partner/merchant/merchantId

Example Request

▾

1curl \
2  --location \
3  --request GET "https://sb-open.revenuemonster.my/v3/partner/merchant/1629258448138509563" \
4  --header "Content-Type: application/json" \
5  --header "Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjIwMTgtMy0xOCIsInR5cCI6IkpXVCJ9..." \
6  --header "X-Signature: sha256 bFGc2JOEFqdI91DE5VXYBUllr+9DHcrrylRFU3i1r72aPmJreljn0dU+nwPSwTH/dTQUiZ9C2aQSF8AuT959EW4WEyEZ6VWgt9gCyZaU/bcOQ/ZIhKc06+uwzivVhAzpbUtG5tm5/sBp4ig6Sk7L6SE0Ecu6Tm0FhYl0qdgZvrTh4EEpLs3kHIuYL9QXKJILfKlu4gTX1Exrt7nNyEr8ndeUMaKYrj3FckMbRtmCwc829SsVp6FAgvoDPnguUJ+VjLF1e9NXhar2JwYjuqMkwsmUWRDbittqCgCCfaPF8anarlLsoXbdYEa7bp9BYp2U/Dw3Xd2MlamEZSR8H+Dosw==" \
7  --header "X-Nonce-Str: VYNknZohxwicZMaWbNdBKUrnrxDtaRhN" \
8  --header "X-Timestamp: 1528450585"

Example Response

JSON▾

1{
2  "item": {
3    "merchant": {
4      "id": "1775025707956484052",
5      "companyName": "Tyson",
6      "brandName": "Tyson",
7      "shortName": "",
8      "companyType": "PRIVATE LIMITED COMPANY (SDN BHD)",
9      "companyLogoUrl": "https://storage.googleapis.com/rm-sandbox-asset/img/merchant.png",
10      "registrationNumber": "XAS1233123",
11      "businessCategory": "COMPUTER AND ELECTRONICS",
12      "businessScope": "some business scope",
13      "sourceOfFunds": "",
14      "customerOrigin": "",
15      "websiteUrl": "https://revenuemonster.my",
16      "establishedAt": "2025-02-02T16:00:00Z",
17      "countryCode": "60",
18      "phoneNumber": "190009090",
19      "addressLine1": "1, Jalan Pertanian 25",
20      "addressLine2": "Taman Universiti",
21      "postcode": "81300",
22      "city": "SKUDAI",
23      "state": "JOHOR",
24      "country": "MALAYSIA",
25      "invoiceAddress": {
26        "addressLine1": "1, Jalan Pertanian 25",
27        "addressLine2": "Taman Universiti",
28        "postcode": "81300",
29        "city": "SKUDAI",
30        "state": "JOHOR",
31        "country": "MALAYSIA"
32      },
33      "isActive": true,
34      "status": "UNVERIFIED",
35      "isMasterMerchant": false,
36      "masterMerchantId": "",
37      "isPartner": true,
38      "partnerId": "4118165203679668885",
39      "gstNo": "",
40      "paymentSubscription": "",
41      "subscription": {
42        "terminalOfflineEWallet": false,
43        "terminalOfflineCreditCard": false,
44        "onlineCreditCard": false,
45        "onlineCreditCardWhitelistCountries": null,
46        "partialRefund": false,
47        "smsOpenApi": false,
48        "recurringPayments": false,
49        "tokenizedPayments": false,
50        "merchantWallet": false,
51        "vopApi": false
52      },
53      "registrationSource": "OPEN_API",
54      "createdAt": "2026-04-01T06:41:47Z",
55      "updatedAt": "2026-04-01T06:41:47Z"
56    },
57    "settlement": {
58      "id": "1775026038746715068",
59      "merchantId": "1775025707956484052",
60      "isDefault": true,
61      "companyName": "Tyson",
62      "companyType": "PRIVATE LIMITED COMPANY (SDN BHD)",
63      "registrationNumber": "XAS1233123",
64      "businessCategory": "COMPUTER AND ELECTRONICS",
65      "businessScope": "some business scope",
66      "sourceOfFunds": "",
67      "customerOrigin": "",
68      "establishedAt": "2025-02-02T16:00:00Z",
69      "countryCode": "60",
70      "phoneNumber": "190009090",
71      "addressLine1": "1, Jalan Pertanian 25",
72      "addressLine2": "Taman Universiti",
73      "postcode": "81300",
74      "city": "SKUDAI",
75      "state": "JOHOR",
76      "country": "MALAYSIA",
77      "isSameBusinessAddress": false,
78      "invoiceAddress": {
79        "addressLine1": "1, Jalan Pertanian 25",
80        "addressLine2": "Taman Universiti",
81        "postcode": "81300",
82        "city": "SKUDAI",
83        "state": "JOHOR",
84        "country": "MALAYSIA"
85      },
86      "inspectList": [
87        {
88          "fullName": "John Doe",
89          "email": "",
90          "position": "",
91          "countryCode": "",
92          "phoneNumber": "",
93          "gender": "MALE",
94          "birthday": "2000-03-22T16:00:00Z",
95          "nationality": "MALAYSIAN",
96          "idType": "IC",
97          "idNo": "000322041234",
98          "beginAt": "",
99          "endAt": ""
100        }
101      ],
102      "status": "UNVERIFIED",
103      "document": {
104        "ctosFileUrl": "https://somefilenedpoint.com",
105        "ownerICFileUrl": "https://somefilenedpoint.com",
106        "directorICFileUrl": "https://somefilenedpoint.com",
107        "shareHolderICFileUrl": "https://somefilenedpoint.com",
108        "businessRegistrationFileUrl": "https://somefilenedpoint.com",
109        "bankStatementFileUrl": "https://somefilenedpoint.com",
110        "moaFileUrl": "https://somefilenedpoint.com",
111        "form24FileUrl": "https://somefilenedpoint.com",
112        "form49FileUrl": "https://somefilenedpoint.com",
113        "section14FileUrl": "https://somefilenedpoint.com",
114        "form44FileUrl": "https://somefilenedpoint.com",
115        "businessSitePhotoFileUrl": "https://somefilenedpoint.com",
116        "essmDocumentFileUrl": "",
117        "letterOfConsentFileUrl": "",
118        "certificateOfRegistrationFileUrl": "",
119        "meetingMinutesFileUrl": "",
120        "organizationChartFileUrl": ""
121      },
122      "documentFile": {
123        "CTOSFileURL": null,
124        "OwnerICFileURL": null,
125        "DirectorICFileURL": null,
126        "ShareHolderICFileURL": null,
127        "BusinessRegistrationFileURL": null,
128        "BankStatementFileURL": null,
129        "MOAFileURL": null,
130        "Form24FileURL": null,
131        "Form49FileURL": null,
132        "Section14FileURL": null,
133        "Form44FileURL": null,
134        "BusinessSitePhotoFileURL": null
135      },
136      "bankAccountNo": "32312323333",
137      "bankAccountType": "CORPORATE",
138      "bankAccountHolderName": "Tyson",
139      "bankName": "HONG LEONG BANK",
140      "bankCode": "HLBB",
141      "averageTicketSize": 0,
142      "averageTurnoverPerMonth": 0,
143      "paymentSubscription": "",
144      "agentRate": 0,
145      "createdAt": "2026-04-01T07:25:41Z",
146      "updatedAt": "2026-04-01T07:25:41Z",
147      "taxInfo": {
148        "tin": "C25219985050",
149        "sstRegNo": "",
150        "ttxRegNo": "",
151        "msic": "00000"
152      },
153      "hasTaxInfo": true,
154      "notificationEmails": null
155    }
156  },
157  "code": "SUCCESS"
158}

Try it out✎Editable — change the headers, then Send▾

Headers

▾

Prerequisite

Products

Miscellaneous

Merchant Info

When to Use

How to Use

Step 1: Get the Merchant ID

Step 2: Make the GET Request

Step 3: Review the Response

Request Parameters

Response Parameters

When to Use​

How to Use​

Step 1: Get the Merchant ID​

Step 2: Make the GET Request​

Step 3: Review the Response​

Request Parameters​

Response Parameters​

When to Use

How to Use

Step 1: Get the Merchant ID

Step 2: Make the GET Request

Step 3: Review the Response

Request Parameters

Response Parameters