API Reference

EMV QR Transaction API

This API can be used by the Issuer’s Mobile App Server to send an EMVCo based QR purchase transaction to the Credit+ Issuing system. Credit+ Issuing validates the request parameters along with the Mobile PIN validation results. This API is applicable for prepaid, credit and debit cards issued on the Pine Labs platform. If the validation issuccessful, Credit+ Issuing further authorizesthe transaction for credit and prepaid cards. For debit cards, it routes the transaction to the Core Banking System (CBS) for authorization. The issuing bank can enable the QR code based purchase option for the cardholder using this API resource. This additional method of capturing transactions leads to better customer experience and is an additionalsource of revenue generation for the issuer.

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 CodeReasonDetails
201000Successful
408912Forward offset time limit violated
408914Backward offset time limit violated
400997Message Type field is mandatory
400997Invalid Message Type
400997Transaction Type field is mandatory
400997Invalid Transaction Type
400997POS Data field is mandatory
400997Invalid POS Data
400997Transaction Amount field is mandatory
400997Transaction Amount field value must have size 12
400997Transaction Amount field must be a positive value with maximum 12 integers and 0 fractions
400997Surcharge Fee field value must have size 9
400997Invalid Surcharge Fee
400997Transmission Date Time field is mandatory
400997Transmission Date Time field must be in MMddHHmmss format
400997Trace Audit Number field is mandatory
400997Trace Audit Number field should be Number
400997Trace Audit Number field value must have size 6
400997Transaction Local Date field is mandatory
400997Transaction Local Date field must be in yyMMddHHmmss format
400997Acquiring Country Code field is mandatory
400997Acquiring Country Code field value must have max length 3
400997Acquiring Institution Code field is mandatory
400997Acquiring Institution Code field value must have max length 6
400997Retrieval Reference Number field is mandatory
400997Retrieval Reference Number field value must have max length 12
400997Retrieval Reference Number field should be Number
400997Terminal Type field is mandatory
400997Invalid Terminal Type
400997PIN Verification field is mandatory
400997Invalid PIN Verification
400997Channel field is mandatory
400997Invalid Channel
400997Card Acceptor Terminal ID field is mandatory
400997Card Acceptor Terminal ID field value must have size 8
400997Card Acceptor Code field is mandatory
400997Card Acceptor Code field value must have size 15
500TRANSACTION_PROCESSING_TIMEOUTThe transaction processing has got timed out. Please try after some timeA reversal entry would be created for the transaction only if the processing is successful
500TRANSACTION_PROCESSING_FAILUREThe transaction cannot be processed. Please try after some time
400994Invalid Encryption-Algorithm header value
400994Invalid Encryption Request Parameters
400994Cryptography error
Language
URL
Click Try It! to start a request and see the response here!