Create Account

Create a new empty account under a merchant. The account is created in UNVERIFIED status and must later be filled in and submitted for review.

When to Use

▾

Use this endpoint when:

• A merchant needs an additional settlement account
• You want to set up the account record before collecting full details

How to Use

▾

Endpoint

POST/v3/account

Step 1: Authenticate

▾

Obtain a valid accessToken for the merchant.

Step 2: Send the POST Request

▾

The body is empty — {}. Signed headers are required.

Step 3: Store the Account ID

▾

The response includes the new account id. Use it to Update Account with details and later Submit Account.

---

Request Parameters

▾

No request body. Authenticated headers only.

---

Response Parameters

▾

itemARRAY

idSTRING

Account ID

Example: "1653895399283266156"

merchantIdSTRING

Merchant ID

Example: "4118165203679668885"

isDefaultBOOLEAN

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

customerOriginSTRING

Customer origin of merchant

Example: "DOMESTIC"

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

Object of Invoice Address

addressLine1STRING

AddressLine1

Example: ""

addressLine2STRING

AddressLine2

Example: ""

postCodeSTRING

Postalcode of invoice address

Example: ""

citySTRING

City

Example: ""

stateSTRING

Address State

Example: ""

countrySTRING

Country

Example: ""

inspectListARRAY

Example: null

fullNameSTRING

Example: ""

emailSTRING

Example: ""

positionSTRING

Example: ""

countryCodeSTRING

Example: ""

phoneNumberSTRING

Example: ""

genderSTRING

Example: ""

birthdaySTRING

Example: ""

nationalitySTRING

Example: ""

iDTypeSTRING

Example: ""

iDNoSTRING

Example: ""

beginDateTimeSTRING

Example: ""

endDateTimeSTRING

Example: ""

statusSTRING

Current status of Account

Example: "VERIFIED"

documentOBJECT

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

documentFileOBJECT

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

createdAtDATETIME

Creation date time of merchant

Example: "2021-01-13T04:35:32Z"

updatedAtDATETIME

Last update date time of merchant

Example: "2021-01-13T04:35:32Z"

codeSTRING

Successfully call this endpoint. If fail, will return error code object (Refer Appendix 1: Error Codes)

Example: "SUCCESS"