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}

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

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