Shop with Points

Rewards

Shop with Points

Have an amazing and unforgettable shopping experience by utilizing your Citibank Reward Points to pay for the goods and services purchased at the partner's website/store at checkout.

Australia

Indonesia

Malaysia

Philippines

Singapore

Thailand

Vietnam

Api's Called

Rewards

Use it when money matters!

Enjoy a great shopping experience by using your Reward Points and pay for your purchases when you checkout from your app/site. 
Zoom In

Identify yourself securely

Enroll for Shop with Points by registering through your preferred Citibank Credit Card. Verify your identity without compromising on the security.

To retrieve access token

For Malaysia,Philippines,Singapore and Thailand markets refer to the API callout1.

For Australia,Hong Kong, Indonesia and Vietnam markets refer to the API callout2. 

Zoom In

API(s) Callout

View Api Callout 1 >
×

Use Case Callout

ShopWithPoints-RewardsLinkage
Enroll the customer to Shop With Points program and returns a token which require activation and that will be used for subsequent API Calls. Separate enrollment is required for each credit card.

End Point
Malaysia: POST /v1/rewards/shopWithpoints/linkage
Philippines: POST /v1/rewards/shopWithpoints/linkage
Singapore: POST /v1/rewards/shopWithpoints/linkage
Thailand: POST /v1/rewards/shopWithpoints/linkage

Parameters

Path
NA

Query
lastFourDigitsCardNumber
citiCardHolderPhoneNumber
merchantCustomerReferenceId

View Api Callout 2 >
×

Use Case Callout

Enroll and Generate Card Access Token

This API is used to enroll the customer to avail services like Rewards Redemption and EPP from the partner's site through a common registration.

OTP is sent to the customer's registered mobile number. The customer completes his registration by validating the OTP and receives a notification from the bank after the successful registration.

Endpoint

Australia: POST /cardAuth/oauth2/authorize/{countryCode}/{businessCode}

Hong-Kong: POST /cardAuth/oauth2/authorize/{countryCode}/{businessCode}

Indonesia: POST /cardAuth/oauth2/authorize/{countryCode}/{businessCode}

Vietnam: POST /cardAuth/oauth2/authorize/{countryCode}/{businessCode}

Parameters

PATH

countryCode

businessCode

Body

lastFourDigitsCardNumber
citiCardHolderPhoneNumber
merchantCustomerReferenceId
grant_type

Validate the OTP sent to your registered mobile number

Complete your registration by validating the OTP sent to your registered mobile number. You will receive a notification from the bank after the successful registration.

To activate access token

For Malaysia,Philippines,Singapore and Thailand markets refer to the API callout1.

For Australia,Hong Kong, Indonesia and Vietnam markets refer to the API callout2. 

Zoom In

API(s) Callout

View Api Callout 1 >
×

Use Case Callout

ShopWithPoints-RewardLinkageActivation
Activates the Rewards token associated with the last four digit of credit card number and mobile number.

End point
Malaysia: PUT /v1/rewards/{rewardLinkCode}/shopWithPoints/activations
Philippines: PUT /v1/rewards/{rewardLinkCode}/shopWithPoints/activations
Singapore: PUT /v1/rewards/{rewardLinkCode}/shopWithPoints/activations
Thailand: PUT /v1/rewards/{rewardLinkCode}/shopWithPoints/activations

Parameters

PATH
rewardLinkCode

View Api Callout 2 >
×

Use Case Callout

Activate Card Access Token 

This API activates customer's access token.Separate token activation is required for each credit card held by the customer.

Endpoint

Australia: POST /cardAuth/oauth2/token/{countryCode}/{businessCode}

Hong-Kong: POST /cardAuth/oauth2/token/{countryCode}/{businessCode}

Indonesia: POST /cardAuth/oauth2/token/{countryCode}/{businessCode}

Vietnam: POST /cardAuth/oauth2/token/{countryCode}/{businessCode}

Parameters

PATH

countryCode

businessCode

Body

controlFlowId
linkageConfirmationCode

Get your Points Balance and use them to pay for your purchases

To get your Reward Points Balance, click on API Callout1.
On the Get Points Balance page click on Confirm and cherish the opportunity to redeem you points by using them to pay for your purchases. Click on API Callout2.
Zoom In

API(s) Callout

View Api Callout 1 >
×

Use Case Callout

Retrieve credit card account reward points balance
Returns the Citi Rewards points balance and details of the points conversion to amount associated with rewards token.

End point
Australia: GET /v1/rewards/{rewardLinkCode}/shopWithPoints/pointBalance
Hong-Kong: GET /v1/rewards/{rewardLinkCode}/shopWithPoints/pointBalance
Indonesia: GET /v1/rewards/{rewardLinkCode}/shopWithPoints/pointBalance
Malaysia: GET /v1/rewards/{rewardLinkCode}/shopWithPoints/pointBalance
Philippines: GET /v1/rewards/{rewardLinkCode}/shopWithPoints/pointBalance
Singapore: GET /v1/rewards/{rewardLinkCode}/shopWithPoints/pointBalance
Thailand: GET /v1/rewards/{rewardLinkCode}/shopWithPoints/pointBalance
Vietnam: GET /v1/rewards/{rewardLinkCode}/shopWithPoints/pointBalance
 
Parameters
Path
RewardLInkCode

View Api Callout 2 >
×

Use Case Callout

ShopWithPoints-Redemption
The customer can buy any item from partner's website using his points that have been accumulated on his credit card.
 
Endpoint
Australia: POST /v1/rewards/{rewardLinkCode}/shopWithPoints/redemption
Hong-Kong: POST /v1/rewards/{rewardLinkCode}/shopWithPoints/redemption
Indonesia: POST /v1/rewards/{rewardLinkCode}/shopWithPoints/redemption
Malaysia: POST /v1/rewards/{rewardLinkCode}/shopWithPoints/redemption
Philippines: POST /v1/rewards/{rewardLinkCode}/shopWithPoints/redemption
Singapore: POST /v1/rewards/{rewardLinkCode}/shopWithPoints/redemption
Thailand: POST /v1/rewards/{rewardLinkCode}/shopWithPoints/redemption
Vietnam: POST /v1/rewards/{rewardLinkCode}/shopWithPoints/redemption
 
Parameters

PATH
NA

Query
RedemptionRequest
cardId
pointsToRedeem
frequentFlyerNumber
redemptionLevel 

Redemption Successful

Congratulations! You have successfully completed your purchase using your Reward points. Thanks for using the Reward Points and keep enjoying their benefits. 
Zoom In