Accounts

In SecurePay Partner API, an Account represents an entity that participates in receiving payments or managing wallet / membership / outlets under the merchant ecosystem.

There are two types of accounts:

Account Type
Description
Example Use Case

Organisation Account

A business entity onboarded to accept payments via SecurePay (FPX, DuitNow, Closed Wallet, etc.).

Restaurant, retailer, service provider

Personal Account

A user-level account associated with a merchant or individual user.

Cashier login, membership customer

API Capabilities

Action
Description

Create account

Partner creates a merchant / personal account

Update account

Modify account details

Fetch account details

Retrieve merchant or user account information

Fetch all accounts

Retrieve all accounts information

Create Account 

POST https://{base_url}/partner/accounts
Parameter
Description
Condition
Example

user_uuid

user_uuid fetch that is fetched from the application

compulsory

d2d1cbd1-ba4b-4ab0-9320-67c2e41703df

name

Account name

optional

SecurePay Sdn Bhd

identity_number

Account identity number. e.g: business registration number.

optional

AZ0221011038

Update Account

PUT https://{base_url}/partner/accounts/:uuid
Parameter
Description
Condition
Example

uuid

Account uuid

compulsory

2c1d41ec-5698-4ecb-8617-dbc9cee95de1

name

Account name

optional

SecurePay Sdn Bhd

identity_number

Account identity number. e.g: business registration number.

optional

AZ0221011038

Fetch Account Details

Need to account details? — Searching by account's uuid to retrieves their full profile.

Fetch All Accounts

Fetch all accounts that under you.

Summary

Merchant accounts represent businesses. Personal accounts represent people.

Last updated