API Reference

Wallet Creation and Wallet Priority

A Cardholder sends a wallet creation or wallet priority request to the Credit+ Issuing system. The Credit+ Issuing system will receive the request. Now, the system will process the request and will perform the necessary validations. Once the validations are successful, the Cardholder will receive the wallet created message. If a validation fails, it sends the corresponding error in the response message. This API is also used to change the priority request for existing wallet as part of Multicurrency Programs and multi-purpose GPR wallets. This API worksfor Primary and Add-on cards. 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 CodeReason
201HDS000Request processed successfully
400994Request Parameters Validation Failure: invalid request
400997Request Parameters Validation Failure: invalid request
401990Unauthorized access
401991Unauthorized access
404998Device(s) does not exist
404902Invalid Form Factor/Form Factor Type for provided Institution.
500993Request processing error
500989Request processing error
500992Request processing error
401990Either Channel is blank or not valid, Please enter Valid Channel.
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 Numberin Form Factor field is blank.
400997Mobile Reference Numberin Form Factor field is blank.
400997Card Pack ID in Form Factor field is blank.
400997Form Factor length should be in between 10 to 24.
400997Wallet information listshould at least have one record.
400997Either Transaction Flag is blank or not valid, Valid Transaction Flags are A / C.
400997Either Wallet Currency OR Priority is blank or currency code Length is not equal to 3 whereas txn flag is A
400997Either Change Wallet Currency OR Priority is blank or currency code Length is not equal to 3.
400API522Invalid Network Code OR not Exists in interface
400API523Invalid Network Code OR not Exists in interface
400433User does not have permission to access this service. Please contact System Administrator.
4008Invalid Session Key
40019Session Key can not be null
400VALPAS002Not valid Acquirer id
400VALPAS003Acquirer is not active
400VALPAS004Incorrect Password
400VALFRM007Invalid CPI
400VALFRM007Card not active
400VALFRM018Card not active
400VALFRM003Invalid Card
400173Invalid form factor type (CARD/CPI)
400382Invalid Program Code
400387In Program there is no limit define for wallet creation
400482Invalid Wallet Plan Code
400585default wallet is not active
400496Active wallet currency limit exceeded
400495No. of wallets permitted has exceeded.
400VALREQ013Wallet closed for currency code:
400485Device against wallet Priority not defined
400VALREQ002New Currency or Wallet Priority should be mandatory
400VALREQ050Priority value should be within the number of currencies allowed for the program
400CURRINST001Currency not defined or inactive for the institution
400VALREQ005Wallet Priority Already Exists
400VALCURR001Wallet Currency Already Exists
400WALINS001Error, insert records into wallet
400WALDEV001Error, recordsinsert into device wallet link
400ALR001Error, insert records for Alert
400ALR002Error, Insert records for Alert
400VALREQ003Error, Currency code and Priority should be mandatory fields
400VALDCUR04Wallet not defined to device for requested currency 2.
400VALDCUR004Wallet not defined to device for requested currency 2.
400VALDCUR05Wallet not defined to device for requested currency 1
400VALDCUR005Wallet not defined to device for requested currency 1.
400CUR1PRT005currency 1 priority does not exists.
400CUR2PRT006currency 2 prority does not exists.
400SWAPCURR002Errorswapping Currency priority2
400VALPRIOR001Currency2 priority does not matched with currency1 priority
400VALCURR003Currency and priority does not match in wallet.
400VALREQ004Wallet Request Flag (TXNFLAG) should be mandatory
400INT001New Wallet Prepaid creation is failed due to internal error. Please contact system admin.
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
Language
URL
Click Try It! to start a request and see the response here!