Ana içeriğe geç

Ödeme Detayı

  • Endpoint: /pws/payment/transaction
  • HTTP Method: GET
  • Request Content-Type: application/json (opsiyonel)
  • Response Content-Type: application/json
  • Yetkilendirme: Geçerli AccessToken zorunludur.
    (Bkz: 2. Kimlik Doğrulama – AccessToken Alınması)

Açıklama​

Bir ödeme işleminin tüm detaylarını döndürür. ERP’deki GetPayment çıktısıyla uyumludur (alan adları & anlamları).

  • Sorgu; transactionId, referenceNumber veya clientReferenceNumber üzerinden yapılabilir.
  • 3D/3D’siz, tek çekim/taksitli tüm işlemler için geçerlidir.

Header Bilgileri​

Header AdıZorunluAçıklama
AuthorizationEvetBearer {AccessToken} formatında geçerli token.
Content-TypeHayırapplication/json

Sorgu Parametreleri (GET)​

Aşağıdaki tanımlayıcılardan en az biri zorunludur

ParametreTipZorunluAçıklama
transactionIdstring (GUID)Evet*İşlemin sistem içi benzersiz ID’si.
referenceNumberstringEvet*Sistem referansı (örn. NTH2P00000002250).
clientReferenceNumberstringEvet*Üye işyeri/sipariş referansı.

* En az birini gönderin. Birden fazlası gönderilirse 404 hatası alırsınız.

Örnek İstekler (GET)

  • /pws/payment/transaction?transactionId=99248acb-3dbe-4654-9f3f-49f02111ee3e
  • /pws/payment/transaction?referenceNumber=NTH2P00000002249
  • /pws/payment/transaction?clientOrderReferenceCode=11001122011

Yanıt (Response) Yapısı

data (Transaction) Alanları

Üst Düzey Alanlar​

AlanTipÖrnekAçıklama
clientReferenceNumberstringnull"ORDER-2025-0001"
referenceNumberstring"NTH2P00000002250"Sistem referans numarası.
tenantIdstring (GUID)"670683c1-2fe0-4846-87b2-6cba9b793ab2"İşlemin ait olduğu tenant.
tenantPosIdstring (GUID)"384badef-11ec-ee11-98f2-005056b0d2e5"Kullanılan POS kaydı.
commRatenumber1.0000Uygulanan komisyon oranı (%).
currencyTypestring"TRY"İşlem para birimi (ör. TRY).
transactionDatestring (ISO datetime)"2025-10-24T17:23:51.5461093"İşlem tarihi/saatı.
transactionDetailIdstring (GUID)"99624afe-b2ee-4483-2f6c-08de12f76968"Detay kaydı id’si.
installmentinteger1Taksit adedi.
lastAmountnumber54.00Son (brüt) tutar.
lastNetAmountnumber53.46Komisyon sonrası net tutar.
idstring (GUID)"49acb76f-d4ea-427b-a1b3-46532fb87653"İşlemin sistem içi benzersiz id’si (transactionId).
vposCommRatenumber1.0000Banka/VPos komisyon oranı.
bankPaymentDaysintegernullnull
paymentSetErpCodestring"Kobi"Ödeme seti ERP kodu.
vPosERPCodestring"29072025"VPos ERP kodu/kimliği.
impersonatedbooleantrueYetkili adına işlem yapıldı bilgisi.
paidTenantIdstring (GUID)nullnull
rePayPlanCodestringnullnull
currencyIdstring (GUID)"8e6cc739-83e0-4af5-accf-a55476e758c6"Para birimi dahili id’si.
erpTransactionCodestringnullnull
erpTransactionCodeUpdateDatestring (ISO)nullnull
errorMessagestringnullnull
errorCodestringnullnull
transactionStatusIdinteger1İşlem durumu (bkz. Durum Notu).
reversalobjectnullnull

agent​

AlanTipÖrnekAçıklama
agentIdstring (GUID)"1f9c9e65-1bf3-48fc-887a-42c325d21cd2"Müşteri/bayi benzersiz id.
namestring"örnek kullanıcı"Ad/Unvan.
emailstring"[email protected]"E-posta.
agentCodestring"NT53240185"Kod.
erpCodestring""ERP kodu.
workplaceCode… businessCodestringnullnull
isCompanybooleanfalseKurumsal mı.
isCustomerbooleantrueMüşteri bayrak.
taxNumberstringnullnull
customerRepresentativeIdsarray[]Temsilci id’leri.
dynamicFieldsarray[]Serbest alanlar.

paymentAccountTransactions​

AlanTipÖrnekAçıklama
amountnumber0.0İlişkili muhasebe/hesap hareketi tutarı.
erpCodestringnullnull
transactionErpCodestringnullnull

paymentGeneral​

AlanTipÖrnekAçıklama
plusInstallmentinteger0Ek taksit.
deferralinteger0Erteleme (gün/ay—kuruluma bağlı).
commApplyTypestring"İçinde"Komisyon uygulama tipi (İçinde/Hariç).
provisionNumberstringnullnull
paymentSetNamestringnullnull
paymentItemGroupNamestringnullnull
paymentItemNamestringnullnull
paymentItemErpCodestringnullnull
paymentItemCodestringnullnull
paymentItemStartDatestringnullnull
paymentItemEndDatestringnullnull
paymentItemAmountnumbernullnull
dynamicFieldsarray[]Serbest alanlar.

paymentContact​

AlanTipÖrnekAçıklama
taxNumberstring"26179246186"TCKN/VKN (örnekte TCKN).
fullNamestring"john Doe"Ad Soyad.
descriptionstring"test"Açıklama.
phoneNumberstring"5888888888"Telefon.
emailstring"[email protected]"E-posta.

paymentSet​

AlanTipÖrnekAçıklama
idstring (GUID)"504978bf-bebd-40c5-89aa-b76f3a20341c"Set id.
namestring"QNB Seti"Set adı.
erpCodestring"QNBSeti"Set ERP kodu.
transactionTypestring"Provizyon"İşlem tipi (kuruluma bağlı).
commApplyTypestring"İçinde"Komisyon uygulama tipi.

creditCard​

AlanTipÖrnekAçıklama
cardHolderNamestring"Test Test"Kart üzerindeki ad.
cardNumberstring (maskeli)"415565******6111"Maskeli PAN (ilk 6 + son 4).
cardTypestring"Visa"Kart şeması.
cardBankstring"QNB Finansbank"Kart bankası.
cardClassstring"Classic"Kart sınıfı.

{  
    "clientReferenceNumber": null,  
    "referenceNumber": "NTH2P00000002250",  
    "tenantId": "670683c1-2fe0-4846-87b2-6cba9b793ab2",  
    "tenantPosId": "384badef-11ec-ee11-98f2-005056b0d2e5",  
    "commRate": 1.0000,  
    "currencyType": "TRY",  
    "transactionDate": "2025-10-24T17:23:51.5461093",  
    "transactionDetailId": "99624afe-b2ee-4483-2f6c-08de12f76968",  
    "installment": 1,  
    "lastAmount": 54.00,  
    "lastNetAmount": 53.46,  
    "id": "49acb76f-d4ea-427b-a1b3-46532fb87653",  
    "vposCommRate": 1.0000,  
    "bankPaymentDays": null,  
    "paymentSetErpCode": "Kobi",  
    "vPosERPCode": "29072025",  
    "impersonated": true,  
    "paidTenantId": null,  
    "rePayPlanCode": null,  
    "agent": {  
        "agentId": "1f9c9e65-1bf3-48fc-887a-42c325d21cd2",  
        "name": "0210 Deneme 0210 Deneme",  
        "email": "[email protected]",  
        "agentCode": "NT53240185",  
        "erpCode": "",  
        "workplaceCode": null,  
        "departmentCode": null,  
        "speCode": null,  
        "authCode": null,  
        "projectCode": null,  
        "salesmanCode": null,  
        "busTranCode": null,  
        "branchCode": null,  
        "businessCode": null,  
        "isCompany": false,  
        "isCustomer": true,  
        "taxNumber": null,  
        "customerRepresentativeIds": [],  
        "dynamicFields": []  
    },  
    "currencyId": "8e6cc739-83e0-4af5-accf-a55476e758c6",  
    "paymentAccountTransactions": [  
        {  
            "amount": 0.0,  
            "erpCode": null,  
            "transactionErpCode": null  
        }  
    ],  
    "paymentGeneral": {  
        "plusInstallment": 0,  
        "deferral": 0,  
        "commApplyType": "İçinde",  
        "provisionNumber": null,  
        "paymentSetName": null,  
        "paymentItemGroupName": null,  
        "paymentItemName": null,  
        "paymentItemErpCode": null,  
        "paymentItemCode": null,  
        "paymentItemStartDate": null,  
        "paymentItemEndDate": null,  
        "paymentItemAmount": null,  
        "dynamicFields": []  
    },  
    "paymentContact": {  
        "taxNumber": "00000000000",  
        "fullName": "John Doe",  
        "description": "test",  
        "phoneNumber": "5074458449",  
        "email": "[email protected]"  
    },  
    "paymentSet": {  
        "id": "504978bf-bebd-40c5-89aa-b76f3a20341c",  
        "name": "QNB Seti",  
        "erpCode": "QNBSeti",  
        "transactionType": "Provizyon",  
        "commApplyType": "İçinde"  
    },  
    "creditCard": {  
        "cardHolderName": "Test Test",  
        "cardNumber": "415565******6111",  
        "cardType": "Visa",  
        "cardBank": "QNB Finansbank",  
        "cardClass": "Classic"  
    },  
    "erpTransactionCode": null,  
    "erpTransactionCodeUpdateDate": null,  
    "errorMessage": null,  
    "errorCode": null,  
    "transactionStatusId": 1,  
    "reversal": null  
}

Notlar & En İyi Uygulamalar​

  • Doğrudan kimlik: En kesin eşleşme için mümkünse transactionId kullanın.

  • 3D akışlarında OTP’den sonra sonucu teyit etmek için bu endpoint’i çağırın.

  • Kart PAN maskeli döner; tam PAN hiçbir zaman dönmez.

  • İptal/İade sonrası güncel durumu tekrar bu uç noktadan kontrol edin.