Introduction
This document describes the integration between the Client Rewards Platform and the Bigcity Rewards Microsite.
The objective of this integration is to allow eligible customers to authenticate using their Customer Unique ID and OTP, view their available reward points, redeem rewards through the Bigcity catalog, and synchronize point consumption with the Client System.
Solution Overview
The Client System is the master source for:
- Customer authentication
- OTP generation and validation
- Points earned
- Available balance points
- Points deduction
- Points reversal
The Bigcity Microsite is responsible for:
- Customer login experience
- Reward catalog management
- Cart management
- Order placement
- Fulfillment processing
- Redemption lifecycle management
System Components
Client System
- Customer master data management
- Customer Unique ID validation
- OTP generation
- OTP validation
- Points ledger management
- Point deduction processing
- Point reversal processing
Bigcity Microsite
- Customer login
- Session management
- Reward catalog display
- Cart management
- Order creation
- Fulfillment processing
- Order status management
End-to-End Process Flow
- Customer Login: Customer enters Customer Unique ID on the microsite
- OTP Generation: Client validates ID and sends OTP to registered mobile
- OTP Verification: Customer enters OTP, receives JWT token and points info
- Dashboard: Customer views available balance points
- Catalog Browse: Customer browses available rewards (E-Gift Vouchers, Merchandise)
- Cart Management: Customer adds items, balance is validated
- Order Placement: Order is created, points are deducted via Client API
- Fulfillment: Bigcity processes and fulfills the order
- Reversal (if needed): Failed orders trigger point reversal via Client API
Points Management
The Client System maintains the master points ledger. Bigcity Microsite does not permanently store customer points. All balance validations are performed using Client APIs.
Key Rules
- Customer cannot redeem beyond available balance
- Cart total must not exceed available points
- Points are deducted only after successful order creation
- Failed orders must trigger reversal API