Card Payment Transactions

Kart İle Yapılacak Olan Ödemede Gelen Bilgiler

Bu parametreler Sipay tarafından gönderilir.

Parametre Tip Açıklama
card_tx_uniq_id long Provizyonun Id'si
card_tx_correlation_id long Provizyonun Ana Id'si (İadeler bu Id ile gelecektir.)
tx_tenant_referance_id string
card_no string Kart Numarası
tenant_customer_no string Temsilci Müşteri Numarası
tenant_wallet_no string Temsilci Cüzdan Numarası
transaction_type string Provizyon İşlem Tipi
request_type string Provizyon Aksiyon Tipi
terminal_type string İşlemin Başladığı Yer
entry_type string
currency_code int Para Birimi
base_amount decimal Ana İşlem Tutarı
fee_amount decimal Komisyon Tutarı (İşlemi başlatan cihazın komisyonu)
tax_amount decimal Vergi Tutarı ( İşlemi başlatan cihazın vergi komisyonu)
total_amount decimal Toplam Tutar
is_advice bool Provizyonun Başarılı Cevap Alanı
hash_key string Medya Anahtarı
merchant_name string Provizyonun Başladığı Cihazın Adı
merchant_id string Provizyonun Başladığı Cihazın Id'si
mcc string Provizyonun Başladığı Cihazın Kategori Kodu
qr_data string TR Karekod İle Yapılan İşlemdeki QR Bilgisi (İşlem TR Karekod ile Başlatıldıysa Parametre Dolu Gelir.)
request_date int İstek Tarihi
request_time int İstek Zamanı
txn_source string Provizyon Kaynağı (N: Yurtiçi, M: Mastercard (Yurtdışı), V: Visa (Yurtdışı)
rrn string Referans Numarası

Dönüş Parametreleri

Parametre Tip Açıklama
correlationId long Provizyonun Id'si
bankingRefNo string Bankanın İşlem Id'si
balanceInformatıonList obje Tutar Bilgilerinin Listesi (balanceInformatıonList tipinde liste dönüşü yapılmalıdır)
type string Tip
previousAmount decimal Önceki Bakiye
CurrencyCode int Para Birimi
CurrentAmount decimal Şimdiki Bakiye
TransactionAmount decimal Balance Information İşlem Tutarı
ResponseCode string Dönüş Kodu
responseDescription string Dönüş Açıklaması
responseMessage string Dönüş Mesajı
isApproved bool Onaylandı mı ? (True: Evet, False: Hayır)

Kart İle Yapılacak Olan Ödemede Gelen Bilgiler :

{
  "card_tx_uniq_id": 4000001489104986,
  "card_tx_correlation_id": 4000001489104986,
  "tx_tenant_referance_id": "",
  "card_no": "434610tbkrea8640",
  "tenant_customer_no": "123123",
  "tenant_wallet_no"": "123123",
  "transaction_type": "SALE",
  "request_type": "NORMAL",
  "terminal_type": "PO",
  "entry_type": "M",
  "currency_code": "949",
  "base_amount": 15.00,
  "fee_amount": 0.00,
  "tax_amount": 0.00,
  "total_amount": 15.00,
  "is_advice": true,
  "hash_key": "",
  "merchant_name": "AKBANK/ USKUDAR ALTUNIZA ISTANBUL TR",
  "merchant_id": "094900001000020",
  "mcc": "6011",
  "qr_data" : "",
  "request_date" : 20211119,
  "request_time" : 112905,
  "txn_source": "M",
  "rrn": "1234567"
}

BAŞARILI YANIT:

{
  "correlationId": 4000001489104986,
  "bankingRefNo": "633719769028",
  "balanceInformationList": [
    {
      "type": "CURRENT",
      "previousAmount": 1000,
      "currencyCode": 949,
      "currentAmount": 985,
      "transactionAmount": 15.00
    }
  ],
  "responseCode": "00",
  "responseDescription": "Approved",
  "responseMessage": "Approved",
  "isApproved": true
}

BAŞARISIZ YANIT:

{
  "correlationId": 4000001489104986,
  "bankingRefNo": "",
  "balanceInformationList": [],
  "responseCode": "51",
  "responseDescription": "Cüzdan Bakiyesi Yetersiz",
  "responseMessage": "Cüzdan Bakiyesi Yetersiz",
  "isApproved": false
}

Transaction Type

TransactionType RequestType Açıklama
SALE NORMAL Provizyon İşlemi / Kart Varlığı Sorgulama
REFUND REVERSAL Provizyonun İadesi
INQUIRY CANCEL (V- Void) Kart Varlığı Sorgulama
LIMIT_INQUIRY REVERSAL OF VOID Kart Varlığı / Bakiye Sorgulama
BALANCE_INQUIRY Fiziksel Kart Bakiye Sorgulama
CASH_WITHDRAWAL Fiziksel Kart Nakit Çekim İşlemi
CASH_DEPOSIT Fiziksel Kart Nakit Yatırma İşlemi

Transaction Terminal Type

Kod Açıklama
PO Pos
AT Atm
EP Epos
IN Internet Banking
IV Ivr
VP Virtual Pos
CT Crt
BR Branch Screen
UA Unattended Pos
VL Validator
KI Kiosk

Response Code

Response Code Description
29 Original Not Found
94 Duplicated
51 Insufficent funds
57 Not allowed to card
96 System Error
05 Not Approved
61 Exceeds withdrawal amount limit
00 Approved