API Reference

Load/Reload API

A vendor initiates a request message for load/reload through API. The Credit+ Issuing system receivesthe message and validatesfor all input fields. The API will load/reload the wallet details of the system. Further, when the GST rate is configured and the cardholder hasinitiated a transaction request through API for prepaid devices/debit/credit devices, the system sends the GST amount (total CGST and SGST/UTGST or IGST) as the response message for the transaction requests received. It is a part of multi-currency programs and multi-purpose GPR wallets.

NOTE: The API, if sent with Card Number Alias (CNA), will fetch the corresponding associated device for further processing only if DEVICE _STATUS_CODE = NORMAL (0) OR (DEVICE_STATUS_CODE = UPGRADE (9) AND UPGRADE_STATUS = 1).

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 CodeError Description
400102Suspected fraud.
400119Transaction not permitted.
400997Either Passcode flag is blank or length is not 1.
400997Either Passcode is blank or Length is greater than 200 whereas Passcode flag is Y.
400997Passcode should be blank when Passcode flag is N.
400997Either Form Factor Type is blank or not valid, Please Enter Valid form factor types as per the request.
400997Form Factor field is blank.
400997Card Number in Form Factor field is blank.
400997Card Pack ID in Form Factor field is blank.
400997Form Factor length should be in between 10 to 24.
400997Either expiry date is blank or Length is greater than 4 whereas form factor type is CRD.
400997Expiry date is not in expected 'yyMM' format whereas form factor type is CRD.
400997Either Transaction Counter is Blank, Not Number or Length is greater than 100.
400997Either Transaction Type is blank or not valid, Valid Transaction Types are O / R.
400997Either Authorization reference Number (RRN) is blank or Length is not equal to 12.
400997Either Trace Audit Number is blank or Length is not equal to 6.
400997Either Transaction Code is blank or not valid, Valid Transaction Codes are IL / LC.
400997Transaction Date Time should not be blank.
400997Transaction Date Time is not in expected 'yyyyMMddHHmmss' format.
400997If Merchant Category Code 'MCC' is not blank then it should be a 4 digit numeric value.
400997If Remark is not blank then length should be less than 100
400997Previous Wallet currency Can Not be Null Or Empty
400997First Wallet Currency is mandatory, it can not be blank.
400997Billing Currency code Length is not equal to 3.
400997Transaction Amount should not be blank and should be greater than Zero.
400997If Currency Conversion Rate is not blank then it should be greater than Zero.
400997Either Transaction Currency is blank or currency code Length is not equal to 3.
500API522Invalid Transaction Channel or interface.
500API523Invalid Transaction Channel or interface
500API433User does not have permission to access this
500VALFRM007Invalid Card Pack ID
500VALFRM007CPI linked to multiple Active Card(s)
500VALFRM007Error Fetching Device
500VALFRM018Card not active
500136Invalid Card
500136Invalid Form factor type (CRD/CPI)
500140Error finding transaction uniqueness
500141RRN and trace audit number combination is not unique.
500APIREV001REVERSAL failed
500171Device status is not normal
500382Invalid Program Code
500170Invalid product type (Prepaid) of device
500CALGSTTAXFailed in For GST Calculation
500MARKUP004Error, GST fees inserting into transaction history
500892Error while populating business date
500141.9Billing/Wallet Currency is Mandatory!
500141.1Transaction and Wallet Currency should be same for GPR/Gift Cards
500142Wallet not available for Currency
500142.1Wallet Number is Mandatory for Multi wallet GPR Cards
500142.9Invalid Wallet Number and Currency Combination
50055Wallet is not active
50092Delivery Date is null
50023Error while fetching travel plan currency
500292Other: Error in Aggregate Limit Fetch
50092Transaction currency not defined
50092Transaction amount not defined
50092Transaction Currency and amount not defined
50092Initial load is already completed for device, please use reload
50092Transaction not permitted
500CONRATE010Conversion rate is not defined for program currency
500CONRATE020Conversion rate is not defined for wallet plan currency
500CONRATE020Conversion rate is not defined for default wallet currency
500111Incorrect Billing Amount - Calculation Error!
500DEVICE_LIMIT_VALIDATIONERROR: DEVICE LIMIT VIOLATED
50092Conversion rate is not defined for travel currency
500API00018N0 Active Trip Present
500FEMA00016INSERTION in TRAVEL_TRIP_HISTORY failed
500API00016Error while fetching details of upcoming trip
500838Error. Client usage counter
500TXNFEES002Error, Calculate Transaction fees
500MRKUPFEE001Error, Calculate Markup fee and with tax
500TXNFEE001Error, transaction amount inserting into transaction history
500TRNFEE002Error, fees inserting into transaction history
500SERTAX003Error, Service tax inserting transaction history
500MARKUP004Error failed Markup fees inserting into transaction history
500MARKUP015Error failed Markup service tax
500APILC001Error, failed loading balance
400911Failed in Wallet Activation
500API002Load and re-load validation failed due to internal error. Please contact system admin
50092Initial load is already completed for device, please use reload
500VALEXP001Expiry Date cannot be null
500VALEXP002Expiry Date is not matching
500VALEXP004Expiry Date is null
500VALEXP005Invalid/Incorrect Expiry Date
500VALEXP006Expiry Date should be null
400997Program code field should only contain [A-Z 0-9] and underscore and must start and end with alphanumeric character.
400997Program Code field value must have max length 6.
400997Device Plan code field should only contain [A-Z 0-9] and underscore and must start and end with alphanumeric character.
400997Device Plan Code field value must have max length 10.
400997Only alphanumeric characters and underscore are allowed.
400997Card Number Alias field value must have max length 24.
400CNA001Bank Does Not Exists
400CNA002Card Number Alias Functionality is not applicable for this Institution
400CNA003Record does not exists for the given details
400CNA005Multiple device numbers are active for given details
400CNA006Error while fetching device details
Language
URL
Click Try It! to start a request and see the response here!