Link a physical Mesra card

This API endpoint links a physical Mesra card to the user.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Successful response payload data

Parameter nameData typeDescription
idstringThe ID of the Mesra membership.
cardNumberstringThe Mesra card number.
userIdstringThe ID of the Setel user.
typestring

Determines if the card type is a company card or consumer card.

Company card can only grant points to consumer cards.

Consumer card can only accumulate and redeem points.

statusstring

The Mesra card status.

Status:
active - Can earn and redeem points
issued - Can earn points but cannot redeem
temporarily_frozen - Can earn points but cannot redeem
frozen - Cannot earn or redeem points

isActiveboolean

Determines if the card is activated.

Inactive cards are allowed to accumulate points but only active cards can redeem points.

isPointEarningEnabledboolean

Determines if the card can earn points.

false - Card cannot earn points
true - Card can earn points

Default value is true.

isPointRedemptionEnabledboolean

Determines if the card can redeem points.

false - Card cannot redeem points
true - Card can redeem points

Default value is true.

pointBalancestringThe remaining balance of loyalty points.
Body Params
string
required

The identification document used to activate the card. E.g. ic number, old ic number, or passport number

string
required

The number on the identification document.

string
required

The physical Mesra card number.

Headers
string
required

A unique ID to reference the interface the request is sent from. Default value is setel but a proper value will be advised by Setel during onboarding.

string
required

The interface type the request is sent from. This value will be provided by Setel during onboarding.

string
required

The user access-token to access Setel API.

Responses

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json