Create Merchant

POST/v3/partner/merchant

What is this?

Create a new merchant account under your Partner account. This endpoint submits merchant information for review. Once approved, the merchant can access RM services.

When to Use

Use this endpoint when:

• A new merchant signs up through your platform
• You need to programmatically create merchant accounts
• You want to onboard merchants in bulk

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

How to Use

Step 1: Get Your Partner Credentials

Obtain your clientId and clientSecret from the RM Merchant Portal > Developer > Application.

Step 2: Prepare Merchant Information

Collect the required merchant details:

• Company name
• Country code and phone number
• Email address
• Contact person's first and last name

Step 3: Make the API Request

Send the merchant information to this endpoint with your authenticated headers.

Step 4: Review the Response

Check the code field in the response. If "SUCCESS", the merchant was created. The merchant and store objects will be returned.

---

Request Parameters

companyNameStringrequired

Registered company name

Example: "Revenue Monster"

countryCodeStringrequired

Country code for phone number (e.g., "60" for Malaysia)

Example: "60"

emailStringrequired

Contact email address

Example: "rmtesting@gmail.com"

firstNameStringrequired

Contact person's first name

Example: "Edwin"

lastNameStringrequired

Contact person's last name

Example: "Testing"

phoneNumberStringrequired

Contact phone number (without country code)

Example: "164699177"

---

Response Parameters

itemObject

Contains merchant, store, and user objects

Example: (See below)

codeString

"SUCCESS" if the merchant was created. Otherwise returns an error code.

Example: "SUCCESS"

---

Merchant object (item.merchant):

idString

Unique merchant ID

Example: "1629292083526787883"

companyNameString

Registered company name

Example: "Revenue Monster"

brandNameString

Brand name if different from company

Example: ""

companyTypeString

Type of company incorporation

Example: ""

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

countryCodeString

Country code for contact

Example: "60"

phoneNumberString

Contact phone number

Example: ""

addressLine1String

Street address line 1

Example: ""

cityString

City

Example: ""

stateString

State/Province

Example: ""

postcodeString

Postal/ZIP code

Example: ""

countryString

Country

Example: ""

isActiveBoolean

Whether the merchant account is active

Example: true

statusString

Merchant status (e.g., "UNVERIFIED", "REVIEWING", "ACTIVE")

Example: "UNVERIFIED"

isPartnerBoolean

Whether this is a partner merchant

Example: true

partnerIdString

Partner ID if applicable

Example: ""

createdAtDateTime

Account creation timestamp

Example: "2021-08-18T13:08:03.530Z"

updatedAtDateTime

Last update timestamp

Example: "2021-08-18T13:08:03.530Z"

---

Subscription object (item.merchant.subscription):

terminalOfflineEWalletBoolean

Offline e-wallet terminal enabled

Example: false

terminalOfflineCreditCardBoolean

Offline credit card terminal enabled

Example: false

onlineCreditCardBoolean

Online credit card enabled

Example: false

---

Store object (item.store):

idString

Unique store ID

Example: "1629292083696729288"

merchantSettlementIdString

Merchant settlement ID

Example: ""

nameString

Store name

Example: "Revenue Monster"

imageUrlString

Store image URL

Example: "https://storage.googleapis.com/rm-prod-asset/img/store.png"

addressLine1String

Street address

Example: ""

postCodeString

Postal code

Example: ""

cityString

City

Example: ""

stateString

State

Example: ""

countryString

Country

Example: ""

countryCodeString

Country code

Example: ""

phoneNumberString

Store phone number

Example: ""

geoLocationObject

Latitude and longitude object

Example: {"latitude": 0, "longitude": 0}

statusString

Store status ("ACTIVE", "INACTIVE")

Example: "ACTIVE"

createdAtDateTime

Creation timestamp

Example: "2021-08-18T13:08:03.535Z"

updatedAtDateTime

Last update timestamp

Example: "2021-08-18T13:08:03.535Z"

---

User object (item.user):

idString

Unique user ID

Example: "1629292083650514742"

firstNameString

User's first name

Example: "EDWIN"

lastNameString

User's last name

Example: "TESTING"

countryCodeString

Country code

Example: "60"

phoneNumberString

Phone number

Example: "164699177"

emailString

Email address

Example: "rmtesting@gmail.com"

avatarUrlString

Avatar image URL

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

statusString

User status ("ACTIVE", "INACTIVE")

Example: "ACTIVE"

isActiveBoolean

Whether user is active

Example: true

currentStoreIdString

Current store ID

Example: ""

createdAtDateTime

Creation timestamp

Example: "2021-08-18T13:08:03.537Z"

updatedAtDateTime

Last update timestamp

Example: "2021-08-18T13:08:03.537Z"