Start TR QR Code

URL

TR QR ile kartlı ödeme başlatmak için ilgili endpoint ve https metod bilgisi aşağıda verilmiştir.

"amount" ve "locationData" parametreleri ATM İşlemleri için zorunludur , işlem ATM işlemi değilse iki parametreninde "" olarak gönderilmesi gereklidir.

NOT : Response'da SUCCESS dönmesi ödeme işleminin gerçekleştiği anlamına gelmez! Kart bilgilerinin başarılı bir şekilde BKM tarafına ulaştığı anlamına gelir. Alınan SUCCESS cevabı sadece BKM nin isteği aldığını ifade eder BKM almış olduğu talebi switch üzerinden ilgili pos cihazına iletmelidir. Herhangi bir nedenden dolayı bu mesaj iletilemezse işlem tamamlanmamış ve ödeme gerçekleşmemiş olur.

HTTP Method URL
POST /v1/Transaction/StartTRQRCode

İstek Parametreleri

Parametre Tip Zorunlu Açıklama
QRCode string Evet QR Kod
AccountNumber string Evet Kullanıcı Hesap Numarası
CardId int Evet Kart Id'si ( Id Bilgisine GetPaymentProviderMediaListByFilter servisinden dönen "id" değerinden ulaşabilirsiniz.)
CardHolderFirstName string Evet Kart Sahibinin Adı
CardHolderLastName string Evet Kart Sahibinin Soyadı
Amount string Evet İşlem Tutarı (ATM İşlemleri)
LocationData string Evet Konum Bilgisi (ATM İşlemleri)

Dönüş Parametreleri

Parametre Tip Açıklama
status int İşlem Statüsü
code string Kod
message string Mesaj
payload obje Veri
resultCode int Sonuç Kodu
resultDescription string Sonuç Açıklaması
qrExpireDate string QR Son Kullanma Tarihi
messageReferenceNumber string İşlemin Uniq Referans Id'si 

İSTEK (POST) :

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

YANIT:

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

Başarısız Yanıt:

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