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

Hong Kong

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.

Refer to the below API callout to retrieve the access token.

Zoom In

API(s) Callout

View Api Callout 1 >
×

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.

A one-time password is sent to the customer's registered mobile number. The customer completes his registration by validating the one-time password 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}

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

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

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

Thailand: 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.

Refer to the below API callout to activate the access token retrieved in previous step.

Zoom In

API(s) Callout

View Api Callout 1 >
×

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}

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

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

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

Thailand: 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

Get Rewards Points Balance

Returns the Citi Rewards Points balance and the details for converting the specified token to a dollar amount.

End point
Australia: POST /v1/creditCards/rewards/pointBalance/search
Hong-Kong: POST /v1/creditCards/rewards/pointBalance/search
Indonesia: POST /v1/creditCards/rewards/pointBalance/search
Malaysia: POST /v1/creditCards/rewards/pointBalance/search
Philippines: POST /v1/creditCards/rewards/pointBalance/search
Singapore: POST /v1/creditCards/rewards/pointBalance/search
Thailand: POST /v1/creditCards/rewards/pointBalance/search
Vietnam: POST /v1/creditCards/rewards/pointBalance/search
 
Parameters

Path
NA

Body
RewardsInquiryRequest : cardId

View Api Callout 2 >
×

Use Case Callout

Redeem Reward Points

This API is used by the customer to submit Shop with Points redemption request. Redemption takes place at the checkout stage, hence the customer can pay for all or part of his transaction bill by using his Rewards Points.
 
Endpoint
Australia: POST /v1/rewards/shopWithPoints/redemption
Hong-Kong: POST /v1/rewards/shopWithPoints/redemption
Indonesia: POST /v1/rewards/shopWithPoints/redemption
Malaysia: POST /v1/rewards/shopWithPoints/redemption
Philippines: POST /v1/rewards/shopWithPoints/redemption
Singapore: POST /v1/rewards/shopWithPoints/redemption
Thailand: POST /v1/rewards/shopWithPoints/redemption
Vietnam: POST /v1/rewards/shopWithPoints/redemption
 
Parameters

PATH
NA

Body
ShopWithPointsPointRedemptionRequest : cardId, transactionReferenceId 

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