LinkPass & UCEM/Athena

Linkpass is NTUC official platform for customers to access various services within FairPrice Group and NTUC, with a single log in. It offers you an easy way to access and manage your profile information and security settings.

UCEM/Athea is platform for managing union memberships and data upstream is LinkPass.

API integration was implementated on 15 November 2022.

Objective

For customer login verification, which consists of 2 steps.

#1 - To verify whether a UPlay customer has or belong to any NTUC membership (eg: NTUC Black card or NTUC Union Silver card or none).

#2 - To retrieve union membership status and details for each UPlay customer at login. Verification takes place at each login and API call is logged.

Login verification takes place at each login and API call is logged.

API endpoint

LinkPass API is one-way traffic, with only retrieval from LinkPass.

LinkPass	Endpoint
UAT
PROD

UCEM API is one-way traffic and upon trigger by customer logins, only Avalon calls UCEM, and not vice versa. UCEM API does not send any updates to Avalon. Implemented on 06 January 2023.

UCEM	Endpoint
UAT	https://apiuat.ntuc.org.sg/external/ucem/member/details;rev=2/ https://apiuat.ntuc.org.sg/external/ucem/membership/details;rev=2/
PROD	https://api.ntuc.org.sg/external/ucem/member/details/ https://api.ntuc.org.sg/external/ucem/membership/details/

Athena API will replace UCEM API, effective 23 September 2024.

Athena	Endpoint
UAT	https://apiuat.ntuc.org.sg/external/member/details;rev=2/ https://apiuat.ntuc.org.sg/external/membership/details;rev=2/
PROD	TBA*

How to identify customer with NTUC membership

Scenario 1 - Customer with LinkPlus (NTUC Black card)

Refer to LINKPLUS section

"uid": "2055998000854918", 
"name": "John", 
"country_code": "65", 
"phone_number": "92220000", 
"email": "[e-mail]", 
"association": { "auth0": "auth0|655961641889z4e088ut3n22", 
"fairprice": 0, 
"linkplus": "8109982066301234" 
},
"email_last_verified": null, 
"phone_number_last_verified": null, 
"date_of_birth": null, 
"memberships": null,

Scenario 2 - Customer with NTUC Union (NTUC Silver)

Refer to MEMBERSHIP section

"uid": "2055998000854918", 
"name": "John", 
"country_code": "65", 
"phone_number": "92220000", 
"email": "[e-mail]", 
"association": { "auth0": "auth0|655961641889z4e088ut3n22", 
"fairprice": 0, 
"linkplus": "8109982066301234" 
},
"email_last_verified": null, 
"phone_number_last_verified": null, 
"date_of_birth": null, 
"memberships": { 
"ntuc_union": { 
"identifier": "199901325123", 
"started_at": "1999-01-01T00:00:00Z", 
"expires_at": "2999-12-31T00:00:00Z" 
}
"myinfo_last_verified": null, 
"created_at": "2023-10-22T09:50:02.154Z", 
"updated_at": "2023-10-22T09:50:03.027Z", 
"metadata": { "authentication_referer": "not provided"