This API is used to redeem reward pointsto purchase a product (merchandise) for requests received through various channelssuch as online banking or mobile banking. The Credit+ Issuing system receives, validates, and processes the request. If the request is successful and adheres to business rules, then number of points coming in the request are redeemed from the account's loyalty point bucket. The system logs the “Reward Redemption (Merchandise)” (Service Code: 512) service request (SR) and sends the service request details in the response message. If the request fails, the system returns the corresponding error code in the response and the SR is not logged. This API is applicable for prepaid, credit and debit products issued on Pine Labs platform.
NOTE: No monetary amount is credited through this API. This API is applicable for general purpose reloadable programs only in case of prepaid products. Further, the device status should not be blocked, cancelled or upgrade and the unpaid status should be normal (0).
HTTP Status and Response Status Matrix
- HTTP Code: This is the response status code issued by a server in response to a client's request made to the server.
- Error Code: This is the error code returned by Credit+ Issuing application in the ‘code’ field of the response message indicating if the request was processed successfully or failed.
- Reason: This is the description of the error code returned by Credit+ Issuing application.
| HTTP Code | Error Code | Reason |
|---|---|---|
| 201 | 000 | Successful. |
| 400 | 119 | Transaction Not Allowed. |
| 500 | 999 | Internal Error. |
| 400 | 954 | Invalid/not matching mobile number/Card number. |
| 400 | 955 | Customer not billed/NTB customer. |
| 400 | 956 | Available reward points are not sufficient for redemption. |
| 400 | 956 | Co-Brand Partner is not Configured/Available. |
| 400 | 957 | Minimum Redemption Points/Amount criteria not met. |
| 400 | 957 | Account Unpaid Status is not Normal. |
| 400 | 957 | Loyalty plan is not configured. |
| 400 | 958 | Card already blocked/cancelled/upgraded. |
| 400 | 959 | Merchandise not configured. |
| 400 | 960 | Redemption allowed for Primary device. |
| 400 | 997 | Card Type field is mandatory. |
| 400 | 997 | Points To Be Redeemed field is mandatory. |
| 400 | 997 | Device Number field is mandatory. |
| 500 | 951 | Internal Error. |
| 400 | 997 | Device Number field value must have min length 4. |
| 400 | 997 | Device Number field value must have max length 24. |
| 400 | 997 | Card Number field should be numeric. |
| 400 | 997 | Mobile number field is mandatory. |
| 400 | LOYT00020 | Error in fetching Product and Account details. |
| 400 | LOYT00028 | Error in fetching data from account. |
| 400 | LOYT00028 | Redemption not Allowed. Account is in Unpaid Status. |
| 400 | LOYT00023 | Redemption Points entered are less than Minimum Points defined on this plan. |
| 400 | LOYT00029 | Total selected points are less than Minimum redemption points on Plan. |
| 400 | LOYT00024 | Error in fetching data from CARD_RANGE, Account No. |
| 400 | LOYT00019 | Error in fetching details of Account No. |
| 400 | LOYT00029 | Error While Getting Redemption Value. |
| 400 | LOYT00032 | Error fetching cumulative balance. |
| 400 | TXN003 | Error updating balance. |