The following APIs are used for Rewards Partner integration:
| Use case → Reference | command / primary value | Description |
|---|
| Fetch reward balances — Fetch Balance All API | POST /loyalty-points/v1/balance/all | Retrieves usable TWID and Zillion reward balances for a customer before checkout. |
| Collect payment with rewards — Collect Payment with Rewards API | _payment with pg=SPLITPAY and splitInfo | Initiates a split payment to burn or earn reward points along with Card or UPI. |
| Use case → Reference | command / primary value | Description |
|---|
| Verify a payment — Verify Payment API | verify_payment | Reconciles the transaction status with PayU after payment. |
| Use case → Reference | command / primary value | Description |
|---|
| Initiate decoupled card payment — Cards Decoupled Flow API | POST _payment (S2S decoupled) | Initiates a server-to-server decoupled card payment for RewardX transactions. |
| Submit the OTP — Submit OTP API | POST ResponseHandler.php with otp | Submits the OTP entered by the customer during decoupled card authentication. |
| Use case → Reference | command / primary value | Description |
|---|
| Refund a split-payment transaction — Refund Transaction API | cancel_refund_transaction | Initiates refunds for split-payment transactions across Card/UPI and reward legs. |
| Check split-payment refund status — Refund Status API for Split Payments | aggregator_check_action_status_txnid | Retrieves the refund status of split-payment child transactions. |
