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 |
Params | Type | Mandatory | Description |
---|---|---|---|
QRCode | string | Yes | QR Code |
AccountNumber | string | Evet | User Account Number |
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) |
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
}