Create Store
Register a new store under a merchant account. The new store becomes available for transactions tied to that merchant.
When to Use
▾
Use this endpoint when:
- A merchant opens a new physical or online location
- You need to programmatically provision stores
- Onboarding a new outlet to existing merchants
How to Use
▾
/v3/storeStep 1: Prepare Store Details
▾
Collect required fields: name, full address, country code, phone, and optional geo-location.
Step 2: Send the POST Request
▾
POST the store payload to /v3/store with signed authentication headers.
Step 3: Store the ID
▾
The response includes the new store id. Use it for transactions and subsequent updates.
Request Parameters
▾
Linkage with payment settlement account
Store Name
Example: "REVENUE MONSTER"
Store Address 1
Example: "B-5-30, 5th Floor, Block Bougainvillea,"
Store Address 2
Example: "PJU 6A, Lebuhraya SPRINT, 10 Boulevard,"
Postcode of store
Example: "47400"
City of store
Example: "Petaling Jaya"
State of store
Example: "Selangor"
Country of store
Example: "Malaysia"
Country code of store contact number
Example: "60"
Phone number of store
Example: "377334080"
Geo Location (latitude and longitude) of store
Example: {"latitude": 3.1349857, "longitude": 101.6136659 }
Response Parameters
▾
Created store details.
Store ID
Example: "6170506694335521334"
Merchant Settlement ID
Example: "6170506694335521334"
Store Name
Example: "REVENUE MONSTER"
Store Address 1
Example: "B-5-30, 5th Floor, Block Bougainvillea,"
Store Address 2
Example: "PJU 6A, Lebuhraya SPRINT, 10 Boulevard,"
Postcode of store
Example: "47400"
City of store
Example: "Petaling Jaya"
State of store
Example: "Selangor"
Country of store
Example: "Malaysia"
Country code of store contact number
Example: "60"
Phone number of store
Example: "377334080"
Geo Location (latitude and longitude) of store
Example: {"latitude": 3.1349857, "longitude": 101.6136659 }
Current status of store
Example: "ACTIVE"
Default store of merchant (first store created upon signup)
Example: true
Creation date time of store
Example: "2018-02-12T08:53:13Z"
Last update date time of store
Example: "2018-02-12T08:53:13Z"
Successfully call this endpoint. If fail, will return error code object (Refer Appendix 1: Error Codes)
Example: "SUCCESS"