API Reference

Reward Redemption (Cash Credit) API

This API is used to redeem reward pointsto credit cash into cardholder's account for requests received through variousthird party 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 (Cash Credit)” (Service Code: 513) 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: 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 CodeError CodeReason
201000Successful
400119Transaction Not Allowed
500999Internal Error
400954Invalid/not matching mobile number/Card number
400955Customer not billed/NTB customer
400956Available reward points are not sufficient for redemption
400956Co-Brand Partner is not Configured/Available
400957Minimum Redemption Points/Amount criteria not met
400957Account Unpaid Status is not Normal
400957Loyalty plan is not configured
400958Card already blocked/cancelled/upgraded
400960Redemption allowed for Primary device
400997Card Type field is mandatory
400997Points To Be Redeemed field is mandatory
400997Device Number field is mandatory
500951Internal Error
400997Device Number field value must have min length 4
400997Device Number field value must have max length 24
400997Card Number field should be numeric
400997Mobile number field is mandatory
400LOYT00020Error in fetching Product and Account details
400LOYT00028Error in fetching data from account
400LOYT00023Redemption Points entered are less than Minimum Points defined on this plan
400LOYT00029Total selected points are less than Minimum redemption points on Plan
400LOYT00024Error in fetching data from CARD_RANGE, Account No
400LOYT00029Error While Getting Redemption Value
400LOYT00029Error While generating new microfilm number
400LOYT00032Error fetching cumulative balance
400LOYT00019Error in fetching details of Account No
400TXN003Error updating balance
Language
URL
Click Try It! to start a request and see the response here!