Pazar Yeri - Ödeme Detay Listesi

Servis Adresi

Ne İçin Kullanılır?

İstek Parametreleri

PaymentDealerAuthentication

PaymentDealerRequest

Örnek İstek (JSON)

{
   "PaymentDealerAuthentication":{
      "DealerCode":"xxx",
      "Username":"xxx",
      "Password":"xxx",
      "CheckKey":"7c662eb7d85e9ec954ba3265d2fff6204e05d878de828ed2cdb3f0627acf4cc8"
   },
   "PaymentDealerRequest":{
      "PaymentId":"41745",
      "OtherTrxCode":"",
      "SubDealerId":"1803"
   }
}

Başarılı İstek Sonucu

PaymentDetail Objesi ile dönen Ödeme ana kaydı durumları şu şekildedir;

PaymentTrxDetailList Array’ i içinde dönen Ödeme detay kaydı durumları şu şekildedir;

PaymentReason	0 : Ödeme işlemi değil (iptal veya iade işlemi) 1 : Ödeme işlemi
VoidRefundReason	İptal iadenin neden yapıldığını gösterir alandır. 0 : İptal iade işlemi değil (Ödeme işlemi olduğu için, bu kod anlamsız) 2 : Dış Manuel iptal / iade işlemi (Pos.moka.com veya api üzerinden iptal) 3 : İç Manuel iptal / iade işlemi (Moka yönetim panelinden yapılan işlem)

Ödemenin tamamı iade edilmişse, ana ödeme kaydında PaymentStatus = 4 durumuna geçer. Kısmi iade yapılmışsa, ödemenin durumu PaymentStatus = 2 olarak kalır.

Ana ödeme kaydında, Amount alanında ödeme tutarı yazar, RefAmount alanında ise bu ödemeye ilişkin iadelerin toplam tutarı yazar.

Bu ana ödemeye ilişkin Trx kayıtlarındaki Amount alanı ise, Trx kaydının tipine göre anlamlandırılır. TrxType = 2 ise ödeme detayı olduğu için Amount alanı ödeme tutarını gösterir. TxType = 4 ise iade detayı olduğu için Amount alanı iade tutarını gösterir.

Ana ödeme kaydı ile detay kayıtları arasındaki ilişkiyi gösterir örnektir :
Tek bir ana ödeme kaydına istinaden, bir veya daha fazla detay kaydı (Transaction kaydı) olabilir. Bir transaction kaydı eklendiği zaman, ana ödeme kaydının durumu değişikliğe uğrayabilir veya aynı kalabilir.

Bu örnekte de görüldüğü üzere, 15 ocakta, 3D olarak 100 liralık bir ödeme gönderilmiş ve başarılı sonuç alınmış. Ardından, 18 ocakta 30 liralık bir iade yapılmak istenmiş ama başarılı olamamış. Sonra aynı iade yeniden denenmiş ve başarılı olmuş. Kısmi iade olduğu için ana ödeme kaydının durumu “Başarılı Ödeme” olarak kalmış. Ardından 22 ocakta, 20 liralık başarılı bir kısmı iade daha olmuş. Ve en sonunda 25 ocakta kalan tüm para iade edilmiş. Ve ana ödeme kaydının durumu, “Başarılı Tam İade” ye dönüşmüş.

Başarılı Sonuç Örneği

{
   "Data":{
      "IsSuccessful":true,
      "ResultCode":"00",
      "ResultMessage":"",
      "ListItemCount":1,
      "PaymentDetail":{
         "DealerPaymentId":41745,
         "OtherTrxCode":"20181205102510",
         "CardHolderFullName":"elif yetimoğlu",
         "CardNumberFirstSix":"526955",
         "CardNumberLastFour":"4444",
         "PaymentDate":"2018-12-05T10:25:09.737",
         "Amount":10.00,
         "RefAmount":0.00,
         "CurrencyCode":"TL",
         "InstallmentNumber":0,
         "DealerCommissionAmount":4.28,
         "DealerGroupCommissionAmount":0.0,
         "IsThreeD":true,
         "Description":"",
         "PaymentStatus":0,
         "TrxStatus":0,
         "SubPaymentList":[
            {
               "DealerPaymentDealerId":14753,
               "DealerId":1803,
               "Amount":7.00,
               "RefAmount":0.00,
               "DealerCommissionAmount":2.11,
               "DealerGroupCommissionAmount":0.19
            },
            {
               "DealerPaymentDealerId":14754,
               "DealerId":1804,
               "Amount":3.00,
               "RefAmount":0.00,
               "DealerCommissionAmount":2.17,
               "DealerGroupCommissionAmount":0.08
            }
         ]
      },
      "PaymentTrxDetailList":[
         {
            "DealerPaymentTrxId":21409,
            "TrxCode":"c681e036-a39e-40a4-88c7-dcd7fe25bedf",
            "TrxDate":"2018-12-05T10:25:09.75",
            "Amount":10.00,
            "TrxType":0,
            "TrxStatus":0,
            "PaymentReason":1,
            "VoidRefundReason":0,
            "VirtualPosOrderId":"",
            "ResultMessage":"",
            "SubPaymentTrxList":[
               {
                  "DealerPaymentTrxDealerId":19905,
                  "DealerPaymentDealerId":14753,
                  "DealerId":1803,
                  "Amount":7.00,
                  "DealerCommissionAmount":2.11,
                  "DealerGroupCommissionAmount":0.19
               },
               {
                  "DealerPaymentTrxDealerId":19906,
                  "DealerPaymentDealerId":14754,
                  "DealerId":1804,
                  "Amount":3.00,
                  "DealerCommissionAmount":2.17,
                  "DealerGroupCommissionAmount":0.08
               }
            ]
         }
      ]
   },
   "ResultCode":"Success",
   "ResultMessage":"",
   "Exception":null
}

Başarısız İstek Sonucu

Başarısız Sonuç Örneği

{
   "Data":null,
   "ResultCode":"PaymentDealer.CheckPaymentDealerAuthentication.InvalidAccount ",
   "ResultMessage":"",
   "Exception":null
}