Submit Merchant for Review

POST/v3/partner/merchant/{merchantID}

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

What is this?

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

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

---

How to Use

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.

Example: (See below)

codeString

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

Example: "SUCCESS"

---

Settlement object (item):

idString

Settlement ID

Example: "1629258558902992793"

merchantIdString

Merchant ID

Example: "1629258448138509563"

isDefaultBool

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 (nullable)

Example: null

inspectListObject (nullable)

Example: null

statusString

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

Example: "REVIEWING"

documentObject

Uploaded document URLs. See document object below.

Example: (See below)

documentFileObject

Uploaded document files. See documentFile object below.

Example: (See below)

bankAccountNoString

Example: ""

bankAccountTypeString

Example: ""

bankAccountHolderNameString

Example: ""

bankNameString

Example: ""

bankCodeString

Example: ""

averageTicketSizeUint

Example: 0

averageTurnoverPerMonthUint

Example: 0

paymentSubscriptionString

Example: ""

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"

---

document object:

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

---

documentFile object:

CTOSFileURLString (nullable)

Example: null

OwnerICFileURLString (nullable)

Example: null

DirectorICFileURLString (nullable)

Example: null

ShareHolderICFileURLString (nullable)

Example: null

BusinessRegistrationFileURLString (nullable)

Example: null

BankStatementFileURLString (nullable)

Example: null

MOAFileURLString (nullable)

Example: null

Form24FileURLString (nullable)

Example: null

Form49FileURLString (nullable)

Example: null

Section14FileURLString (nullable)

Example: null

Form44FileURLString (nullable)

Example: null

BusinessSitePhotoFileURLString (nullable)

Example: null