Skip to main content

Register Loyalty Member

Register a new loyalty member under the merchant. Returns the new member's profile record.

When to Use

Use this endpoint when:

  • Onboarding a new customer to your loyalty program
  • Registering a member during checkout flow

How to Use

Endpoint
POST/v3/loyalty/member

POST member details (name, country code, phone, email, NRIC, etc.) to create the record. The response includes the new member's key.


Request Parameters

nameSTRINGrequired

Member name

Example: "Oska"

countryCodeSTRINGrequired

Country code of member contact number

Example: "60"

phoneNumberSTRINGrequired

Phone number of member

Example: "1878241234"

emailSTRINGrequired

Email address of member

Example: "[email protected]"

nricSTRINGrequired

IC Number

Example: "950711011234"

birthDateSTRINGrequired

Member Birth Date

Example: "1995-07-11T00:00:00Z"

genderSTRINGrequired

Gender

Example: "MALE"

pointINTEGERrequired

Loyalty Point

Example: 0

addressOBJECTrequired

Refer to explanation below

Example: (Refer to explanation below)

Response Parameters

itemOBJECT

Profile object

idSTRING

Profile ID

Example: ""

keySTRING

Profile Key (Internal Usage)

Example: "EhIKBk1lbWJlchDOuOKz24XWkg4SGQoNTWVtYmVyUHJvZmlsZRDl-MTxiPOPjzY"

nameSTRING

Profile name

Example: "Oska"

emailSTRING

Profile email

Example: "[email protected]"

nricSTRING

IC Number

Example: "950711011234"

birthDateSTRING

User Birth Date (YYYY:MM:DD)

Example: "1995-07-11"

genderSTRING

Gender

Example: "MALE"

addressOBJECT

Refer to explanation below

addressLine1STRING

Address 1

Example: ""

addressLine2STRING

Address 2

Example: ""

postcodeSTRING

Postcode

Example: ""

citySTRING

City

Example: ""

stateSTRING

State

Example: ""

countrySTRING

Country

Example: ""

memberTierSTRING

Member Tier Point

Example: null

totalLoyaltyPointINTEGER

Total Loyalty Point

Example: 0

hasPinCodeBOOLEAN

User Pin

Example: false

loyaltyPointBalanceINTEGER

Total Point Balance left

Example: 0

spendingPointINTEGER

Point Spend

Example: 0

creditBalanceINTEGER

Credit Balance

Example: 0

statusSTRING

Profile Status

Example: "ACTIVE"

createdAtDATETIME

Creation date time

Example: "2018-10-19T03:39:47Z"

updatedAtDATETIME

Last update date time

Example: "2020-06-29T10:14:33Z"

codeSTRING

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

Example: "SUCCESS"