Start TR QR Code

URL

Relevant endpoint and https method information for initiating card payment with TR QR is given below

"amount" and "locationData" parameters are mandatory for ATM Transactions, if the transaction is not an ATM transaction, both parameters must be sent as ""

NOTE: Returning SUCCESS in the Response does not mean that the payment has been completed! It means that the card information has successfully reached BKM. The SUCCESS response received only indicates that BKM received the request. BKM must forward the request it receives to the relevant POS device via the switch. If this message cannot be delivered for any reason, the transaction will not be completed and the payment will not be made.

HTTP Method	URL
POST	/v1/Transaction/StartTRQRCode

Request Params

Params	Type	Mandatory	Description
QRCode	string	Yes	QR Code
CardId	integer	Yes	Card Id
CardHolderFirstName	string	Yes	Card Holder First Name
CardHolderLastName	string	Yes	Card Holder Last Name
Amount	string	Yes	Amount ( ATM Transactions)
LocationData	string	Yes	Location Data (ATM Transactions)

Response Params

Params	Type
status	integer
code	string
message	string
payload	object
resultCode	integer
resultDescription	string
qrExpireDate	string
messageReferenecNumber	string

REQUEST (POST) :

{ 
    "QRCode": "99999921111613423221d1f09a88f8c5739a7954572a2056a2C4EE", 
    "CardId": 4346100007612917, 
    "CardHolderFirstName": "test", 
    "CardHolderLastName": "test", 
    "Amount": "",
    "LocationData": ""
}

RESPONSE:

{
  "status": 0,
  "code": null,
  "message": null,
  "payload": {
    "resultCode": 0,
    "resultDescription": "SUCCESS",
    "qrExpireDate": null,
    "messageReferenceNumber": "d8b521ee-aed1-48ae-a869-bab9b6d552cd"
  }
}

Fail Response:

{
  "status": 2,
  "code": "324",
  "message": "Kare kod geçerlilik süresi doldu",
  "payload": null
}