Submit Merchant for Review

note

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

Submit a merchant's completed application for review by Revenue Monster. Once submitted, the merchant's status changes to REVIEWING and RM will assess the application.

When to Use

▾

Use this endpoint when:

• A merchant has completed all required fields and documents
• You are ready to submit the merchant for RM's review process

tip

Before submitting, ensure all required information is complete. Incomplete applications may be rejected.

---

How to Use

▾

Endpoint

POST/v3/partner/merchant/{merchantId}

Step 1: Verify Merchant Completeness

▾

Confirm that all required merchant details and documents have been uploaded. Check the merchant's information using Get Merchant.

Step 2: Get the Merchant ID

▾

Locate the merchantID for the merchant you want to submit for review.

Step 3: Make the POST Request

▾

Send the request with the merchantID as a path parameter. No request body is required.

Step 4: Review the Response

▾

Check the code field. If "SUCCESS", the merchant has been submitted. The status will change to "REVIEWING".

---

Request Parameters

▾

merchantIDSTRINGrequired

The ID of the merchant to submit for review. Pass it in the URL path.

Example: "1629292083526787883"

---

Response Parameters

▾

itemOBJECT

Contains the settlement/merchant details.

idSTRING

Settlement ID

Example: "1629258558902992793"

merchantIdSTRING

Merchant ID

Example: "1629258448138509563"

isDefaultBOOLEAN

Whether this is the default settlement account

Example: true

companyNameSTRING

Company name of merchant

Example: "REVENUE MONSTER"

companyTypeSTRING

Type of company incorporation

Example: "SOLE PROPRIETOR"

registrationNumberSTRING

Registration number of merchant

Example: "12344"

businessCategorySTRING

Business category of merchant

Example: "SOFTWARE AND IT"

businessScopeSTRING

Business scope of merchant

Example: "SOFTWARE AND IT"

sourceOfFundsSTRING

Source of funds of merchant

Example: ""

customerOriginSTRING

Customer origin of merchant

Example: ""

establishedAtDATETIME

Established date time of merchant

Example: "2018-03-26T04:50:57Z"

countryCodeSTRING

Country code of merchant contact number

Example: "60"

phoneNumberSTRING

Phone number of merchant

Example: "377334080"

addressLine1STRING

Address 1 of merchant

Example: "20, JALAN JASA 38, TAMAN MUTIARA RINI"

addressLine2STRING

Address 2 of merchant

Example: ""

postcodeSTRING

Postcode of merchant

Example: "81300"

citySTRING

City of merchant

Example: "Selangor"

stateSTRING

State of merchant

Example: "Selangor"

countrySTRING

Country of merchant

Example: "Malaysia"

isSameBusinessAddressBOOLEAN

Example: false

invoiceAddressOBJECT

Example: null

inspectListOBJECT

Example: null

statusSTRING

Current status of settlement. Changes to "REVIEWING" after submission.

Example: "REVIEWING"

documentOBJECT

Uploaded document URLs

ctosFileUrlSTRING

Example: ""

ownerICFileUrlSTRING

Example: ""

directorICFileUrlSTRING

Example: ""

shareHolderICFileUrlSTRING

Example: ""

businessRegistrationFileUrlSTRING

Example: ""

bankStatementFileUrlSTRING

Example: ""

moaFileUrlSTRING

Example: ""

form24FileUrlSTRING

Example: ""

form49FileUrlSTRING

Example: ""

section14FileUrlSTRING

Example: ""

form44FileUrlSTRING

Example: ""

businessSitePhotoFileUrlSTRING

Example: ""

essmDocumentFileUrlSTRING

Example: ""

letterOfConsentFileUrlSTRING

Example: ""

certificateOfRegistrationFileUrlSTRING

Example: ""

meetingMinutesFileUrlSTRING

Example: ""

organizationChartFileUrlSTRING

Example: ""

documentFileOBJECT

Uploaded document file URLs

CTOSFileURLSTRING

Example: null

OwnerICFileURLSTRING

Example: null

DirectorICFileURLSTRING

Example: null

ShareHolderICFileURLSTRING

Example: null

BusinessRegistrationFileURLSTRING

Example: null

BankStatementFileURLSTRING

Example: null

MOAFileURLSTRING

Example: null

Form24FileURLSTRING

Example: null

Form49FileURLSTRING

Example: null

Section14FileURLSTRING

Example: null

Form44FileURLSTRING

Example: null

BusinessSitePhotoFileURLSTRING

Example: null

bankAccountNoSTRING

Example: ""

bankAccountTypeSTRING

Example: ""

bankAccountHolderNameSTRING

Example: ""

bankNameSTRING

Example: ""

bankCodeSTRING

Example: ""

averageTicketSizeINTEGER

Example: 0

averageTurnoverPerMonthINTEGER

Example: 0

paymentSubscriptionSTRING

Example: ""

agentRateNUMBER

Agent commission rate

Example: 0

createdAtDATETIME

Creation date time of settlement

Example: "2021-08-18T14:33:49Z"

updatedAtDATETIME

Last update date time of settlement

Example: "2021-08-18T14:33:49Z"

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

codeSTRING

"SUCCESS" if the call succeeded. Otherwise returns an error code object. See Appendix 1: Error Codes.

Example: "SUCCESS"