Pazar Yeri - Bayi Ekstresini Görme

Servis Adresi

İstek Parametreleri

PaymentDealerAuthentication

Parametre Açıklama
DealerCode string Ruut sistemi tarafından verilen bayi kodu
Username string Ruut sistemi tarafından verilen Api kullanıcı adı
Password string Ruut sistemi tarafından verilen Api şifresi
CheckKey string Kontrol anahtarı (DealerCode + "MK" + Username + "PD" + Password) String olarak birleştirilen bu bilgilerin SHA-256 hash algoritmasından geçirilmesiyle oluşturulur.
Buraya tıklayarak deneme ekranına gidebilirsiniz.

DealerStatementRequest

Parametre Açıklama
StatementStartDate datetime Ekstrenin başlangıç tarihi (yyyy-MM-dd ) (opsiyonel)
StatementEndDate datetime Ekstrenin bitiş tarihi (yyyy-MM-dd ) (opsiyonel)
AccountingId integer İlgili işleme ait muhasebe id. (opsiyonel)
StatementId integer Ekstre id. (opsiyonel)
SubDealerId integer Alt bayi id, (zorunlu)

Returns

Parametre Açıklama
StatementList array

DealerStatementId integerBayi ekstre id.
CurrencyId integerPara birimi id.
StatementStartDate datetimeEkstre başlangıç tarihi.
StatementEndDate datetimeEkstre bitiş tarihi.
WillBePaidOn datetimeÖdemenin bayiye ne zaman yatırılacağı bilgisi.
StatementStatus integerEkstrenin durumu.
SalesCount integerSatışların sayısı.
SalesTotal decimalSatışların toplamı.
SalesCommissionTotal decimalSatışların komisyon toplamı.
RefundCount integerİade sayısı.
RefundTotal decimalİadelerin toplamı.
RefundCommissionTotal decimalİade komisyonlarının toplamı.
DealerAccountingId integerBayi muhasebe id.
Status integerDurum.
PaymentTrxList array

DealerPaymentId integerÖdeme id
OtherTrxCode stringKarşı işlem numarası
CardHolderFullName stringKart sahibinin adi ve soyadı
CardNumberFirstSix stringKart numarasının ilk 6 hanesi
CardNumberLastFour stringKart numarasının son 4 hanesi
PaymentDate datetimeÖdeme tarihi
Amount decimalÖdeme tutarı
RefAmount decimalİade tutarı
CurrencyCode stringPara birimi
InstallmentNumber integerTaksit sayısı
DealerCommissionAmount decimalBayi komisyon tutarı
IsThreeD bool3D Ödeme mi?
Description stringÖdeme açıklaması
PaymentStatus stringÖdeme durumu (ön provizyon, ödeme, iptal, iade vb.)
TrxStatus stringİşlem durumu (bekliyor, başarılı, basarisiz vb.)
Software stringÖdemenin gönderildiği platform
SubPaymentList array

DealerPaymentDealerId integerAlt ödeme liste id.
DealerId integerÜye iş yeri id.
Amount decimalAlt üye iş yeri ödeme tutarı.
RefAmount decimalAlt üye iş yeri iade tutarı.
DealerCommissionAmount decimalÜye iş yeri komisyon tutarı
DealerGroupCommissionAmount decimalÜst üye iş yeri komisyon tutarı
PaymentTrxDetailList array

DealerPaymentTrxId integerÖdeme hareketi id.
TrxCode stringBanka ile Ruut arasındaki işlem kodu.
TrxDate datetimeİşlem tarihi.
Amount decimalÖdeme tutarı.
TrxType integerÖdeme işleminin tipi.
TrxStatus integerÖdeme işleminin durumu.
PaymentReason integerÖdeme durumu (iptal, iade, normal ödeme, vb.)
VoidRefundReason integerİptal veya iadenin sebebini gösteren kod.
VirtualPosOrderId integerSanal pos işlem numarası.
ResultMessage stringBankadan dönen hata mesajı.
SubPaymentTrxList array

DealerPaymentTrxDealerId integerAlt ödeme hareketi id.
DealerPaymentDealerId integerAlt ödeme liste id.
DealerId integerÜye iş yeri id.
Amount decimal Ödeme tutarı.
DealerCommissionAmount decimalÜye iş yeri komisyon tutarı
DealerGroupCommissionAmount decimalÜst üye iş yeri komisyon tutarı

Örnek İstek (JSON) 


{
   "DealerAuthentication":{
      "DealerCode":"XXXX",
      "Username":"XXXX",
      "Password":"XXXXX",
      "CheckKey":"28ba1f316e661ee7a0477a13aa30613da548c94a8098829af9255b04d7e916e3"
   },
   "DealerStatementRequest":{
      "StatementStartDate":"2020-04-01",
      "StatementEndDate":"2020-05-05",
      "AccountingId":"",
      "StatementId":"735",
      "SubDealerId":"12345"
   }
}

Başarılı İstek Sonucu

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


{
   "Data":{
      "IsSuccessful":true,
      "ResultCode":"",
      "ResultMessage":"",
      "ListItemCount":1,
      "StatementList":[
         {
            "DealerStatementId":735,
            "CurrencyId":0,
            "StatementStartDate":"2020-04-10T00:00:00",
            "StatementEndDate":"2020-04-11T00:00:00",
            "WillBePaidOn":"2020-04-17T00:00:00",
            "StatementStatus":3,
            "SalesCount":2,
            "SalesTotal":100.00,
            "SalesCommissionTotal":4.00,
            "RefundCount":0,
            "RefundTotal":0.00,
            "RefundCommissionTotal":0.00,
            "DealerAccountingId":0,
            "Status":0,
            "PaymentTrxList":[
               {
                  "PaymentDetail":{
                     "DealerPaymentId":56484,
                     "OtherTrxCode":"20200411153306",
                     "CardHolderFullName":"Zeynep HASHAN",
                     "CardNumberFirstSix":"526955",
                     "CardNumberLastFour":"4444",
                     "PaymentDate":"2020-04-11T15:33:06.557",
                     "Amount":100.00,
                     "RefAmount":0.00,
                     "CurrencyCode":"TL",
                     "InstallmentNumber":0,
                     "DealerCommissionAmount":3.50,
                     "DealerGroupCommissionAmount":2.00,
                     "IsThreeD":false,
                     "Description":"",
                     "PaymentStatus":2,
                     "TrxStatus":1,
                     "Software":"Possimulation",
                     "SubPaymentList":[
                        {
                           "DealerPaymentDealerId":30228,
                           "DealerId":167,
                           "Amount":50.00,
                           "RefAmount":0.00,
                           "DealerCommissionAmount":2.00,
                           "DealerGroupCommissionAmount":1.00
                        }
                     ]
                  },
                  "PaymentTrxDetailList":[
                     {
                        "DealerPaymentTrxId":37622,
                        "TrxCode":"c067dec9-953c-4cb3-ac9f-aba91dab9a67",
                        "TrxDate":"2020-04-11T15:33:06.613",
                        "Amount":100.00,
                        "TrxType":2,
                        "TrxStatus":1,
                        "PaymentReason":1,
                        "VoidRefundReason":0,
                        "VirtualPosOrderId":"Test-8e6dae7f-7eac-4b13-a619-d879a0a005b8",
                        "ResultMessage":"",
                        "SubPaymentTrxList":[
                           {
                              "DealerPaymentTrxDealerId":37134,
                              "DealerPaymentDealerId":30228,
                              "DealerId":167,
                              "Amount":50.00,
                              "DealerCommissionAmount":2.00,
                              "DealerGroupCommissionAmount":1.00
                           }
                        ]
                     }
                  ]
               },
               {
                  "PaymentDetail":{
                     "DealerPaymentId":56485,
                     "OtherTrxCode":"20200411153308",
                     "CardHolderFullName":"Zeynep HASHAN",
                     "CardNumberFirstSix":"526955",
                     "CardNumberLastFour":"4444",
                     "PaymentDate":"2020-04-11T15:33:09.117",
                     "Amount":100.00,
                     "RefAmount":0.00,
                     "CurrencyCode":"TL",
                     "InstallmentNumber":0,
                     "DealerCommissionAmount":3.50,
                     "DealerGroupCommissionAmount":2.00,
                     "IsThreeD":false,
                     "Description":"",
                     "PaymentStatus":2,
                     "TrxStatus":1,
                     "Software":"Possimulation",
                     "SubPaymentList":[
                        {
                           "DealerPaymentDealerId":30230,
                           "DealerId":167,
                           "Amount":50.00,
                           "RefAmount":0.00,
                           "DealerCommissionAmount":2.00,
                           "DealerGroupCommissionAmount":1.00
                        }
                     ]
                  },
                  "PaymentTrxDetailList":[
                     {
                        "DealerPaymentTrxId":37623,
                        "TrxCode":"3ba04827-66fb-45f0-b720-fbeb77340c09",
                        "TrxDate":"2020-04-11T15:33:09.13",
                        "Amount":100.00,
                        "TrxType":2,
                        "TrxStatus":1,
                        "PaymentReason":1,
                        "VoidRefundReason":0,
                        "VirtualPosOrderId":"Test-dbe8cc01-904a-43e2-8a32a2b1f5feed5e",
                        "ResultMessage":"",
                        "SubPaymentTrxList":[
                           {
                              "DealerPaymentTrxDealerId":37136,
                              "DealerPaymentDealerId":30230,
                              "DealerId":167,
                              "Amount":50.00,
                              "DealerCommissionAmount":2.00,
                              "DealerGroupCommissionAmount":1.00
                           }
                        ]
                     }
                  ]
               }
            ]
         }
      ]
   },
   "ResultCode":"Success",
   "ResultMessage":"",
   "Exception":null
}

Başarısız İstek Sonucu

ResultCodeAçıklama
Dealer.CheckDealerAuthentication.InvalidRequestCheckKey hatalı ya da nesne hatalı ya da JSON bozuk olabilir.
Dealer.CheckDealerAuthentication.InvalidAccountBöyle bir bayi bulunamadı.
Dealer.GetStatementListMarketPlace.InvalidRequestCheckKey hatalı ya da nesne hatalı ya da JSON bozuk olabilir.
PaymentDealer.GetStatementListMarketPlace.DealerNotAuthorizedBu bayinin yetkisi yok.
Dealer.GetStatementListMarketPlace.SubDealerIdRequiredAlt bayi id geçersiz.
Dealer.GetStatementListMarketPlace.SubDealerNotFoundAlt bayi bulunamadı.
Dealer.GetStatementListMarketPlace.InvalidDateFormatTarih biçimi geçersiz.
Dealer.GetStatementListMarketPlace.StatementNotFoundEkstre bulunamadı.
Dealer.GetStatementListMarketPlace.InvalidStatementIdOrAccountingIdEkstre id veya muhasebe id geçersiz.
EX Beklenmeyen bir hata oluştu

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


{
   "Data":null,
   "ResultCode":" Dealer.GetStatementListMarketPlace.SubDealerIdRequired",
   "ResultMessage":"",
   "Exception":null
}