Bayi Ödeme Detayı (İşlem Sorgulama)

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

Açıklama

Bu servis, VPWS üzerinden gerçekleştirilmiş bir ödeme işleminin tüm detaylarını döndürür.

Sorgulama

• referenceCode
• transactionId
• clientReferenceNumber

parametrelerinden biri ile yapılabilir.

Not: İşlem yalnızca ilgili bayiye ait ise görüntülenebilir. Başka bayiye ait işlemler için 404 veya 403 hatası dönebilir.

Query Parametreleri

Parametre	Tip	Zorunlu	Açıklama
referenceCode	string	Evet*	Sistem referans numarası (örn: NTH2P00000003086)

Örnek İstek

Method: GET
Authorization: Bearer {AccessToken}
URL: https://pgw.netahsilatdemo.com/vpws/transaction?referenceCode=NTH2P00000003086

Response (Yanıt) Yapısı

Servis doğrudan Transaction nesnesi döner.

Üst Düzey Alanlar

Alan	Tip	Açıklama
clientReferenceNumber	string/null	Bayi sipariş referansı
referenceNumber	string	Sistem referans numarası
tenantId	string (GUID)	İşlemin ait olduğu ana tenant
tenantPosId	string (GUID)	Kullanılan POS
commRate	number	Uygulanan komisyon oranı
currencyType	string	Para birimi
transactionDate	string (ISO 8601)	İşlem tarihi
installment	int	Taksit sayısı
lastAmount	number	Güncel brüt tutar
lastNetAmount	number	Komisyon sonrası net tutar
id	string (GUID)	transactionId
vposCommRate	number	VPOS komisyon oranı
bankPaymentDays	int/null	Banka ödeme vadesi
paymentSetErpCode	string	ERP ödeme seti kodu
vPosERPCode	string	POS ERP kodu
impersonated	boolean	Yetkili adına işlem yapıldı mı
paidTenantId	string (GUID)	Ödemeyi gerçekleştiren bayi tenant'ı
rePayPlanCode	string/null	Yeniden ödeme planı
currencyId	string (GUID)	Para birimi dahili ID
erpTransactionCode	string/null	ERP fiş kodu
erpTransactionCodeUpdateDate	string/null	ERP güncelleme zamanı
errorMessage	string/null	Hata mesajı
errorCode	string/null	Hata kodu
transactionStatusId	int	İşlem durumu
reversal	object/null	İptal/İade bilgisi

Agent (Bayi Bilgisi)

Alan	Tip	Açıklama
agentId	string (GUID)	Bayi kimliği
name	string	Bayi adı
agentCode	string	Bayi kodu
taxNumber	string	VKN/TCKN
isCompany	boolean	Kurumsal mı
isCustomer	boolean	Müşteri mi
dynamicFields	array	Serbest alanlar

PaymentGeneral

Alan	Tip	Açıklama
plusInstallment	int	Ek taksit
deferral	int	Erteleme
commApplyType	string	Komisyon tipi
provisionNumber	string	Banka provizyon numarası
paymentSetName	string/null	Ödeme seti adı
paymentItemName	string/null	Kalem adı

PaymentContact

Alan	Tip	Açıklama
taxNumber	string	TCKN/VKN
fullName	string	Kart sahibi
phoneNumber	string	Telefon
email	string	E-posta

CreditCard

Alan	Tip	Açıklama
cardHolderName	string	Kart üzerindeki ad
cardNumber	string	Maskeli PAN (ilk 6 + son 4)
cardType	string/null	Kart tipi
cardBank	string/null	Banka
cardClass	string/null	Kart sınıfı

Örnek Response

{
  "clientReferenceNumber": null,
  "referenceNumber": "NTH2P00000003086",
  "tenantId": "670683c1-2fe0-4846-87b2-6cba9b793ab2",
  "tenantPosId": "03cbbf3e-ff9e-ee11-98ef-005056b0d2e5",
  "commRate": 1.0000,
  "currencyType": "TRY",
  "transactionDate": "2026-02-26T14:53:20.8587036",
  "installment": 1,
  "lastAmount": 250.00,
  "lastNetAmount": 247.50,
  "id": "80a2933f-e074-49dd-a80f-4ecc2e0f71a2",
  "vposCommRate": 1.0000,
  "bankPaymentDays": null,
  "paymentSetErpCode": "Kobi",
  "vPosERPCode": "",
  "impersonated": true,
  "paidTenantId": "7e7c1ef5-99b2-4b35-827e-777d5c1688c1",
  "rePayPlanCode": null,
  "agent": {
    "agentId": "7e7c1ef5-99b2-4b35-827e-777d5c1688c1",
    "name": "sdktst - 1",
    "email": null,
    "agentCode": "123",
    "erpCode": "",
    "workplaceCode": null,
    "departmentCode": null,
    "speCode": null,
    "authCode": null,
    "projectCode": null,
    "salesmanCode": null,
    "busTranCode": null,
    "branchCode": null,
    "businessCode": null,
    "isCompany": false,
    "isCustomer": false,
    "taxNumber": "89637944864",
    "customerRepresentativeIds": [
      "3bcbbd17-bb1a-497f-b9ae-5d003e8ce0b1",
      "3bcbbd17-bb1a-497f-b9ae-5d003e8ce0b1"
    ],
    "dynamicFields": []
  },
  "currencyId": "8e6cc739-83e0-4af5-accf-a55476e758c6",
  "paymentAccountTransactions": [
    {
      "amount": 0.0,
      "erpCode": null,
      "transactionErpCode": null
    }
  ],
  "paymentGeneral": {
    "plusInstallment": 0,
    "deferral": 0,
    "commApplyType": "İçinde",
    "provisionNumber": "S58769",
    "paymentSetName": null,
    "paymentItemGroupName": null,
    "paymentItemName": null,
    "paymentItemErpCode": null,
    "paymentItemCode": null,
    "paymentItemStartDate": null,
    "paymentItemEndDate": null,
    "paymentItemAmount": null,
    "dynamicFields": []
  },
  "paymentContact": {
    "taxNumber": "23671373136",
    "fullName": "test   soyadı",
    "description": "est",
    "phoneNumber": "5002583519",
    "email": "[email protected]"
  },
  "paymentSet": {
    "id": "504978bf-bebd-40c5-89aa-b76f3a20341c",
    "name": "QNB Seti",
    "erpCode": "QNBSeti",
    "transactionType": "Satış",
    "commApplyType": "İçinde"
  },
  "creditCard": {
    "cardHolderName": "Emre Çağlar",
    "cardNumber": "415565******6111",
    "cardType": null,
    "cardBank": null,
    "cardClass": null
  },
  "erpTransactionCode": null,
  "erpTransactionCodeUpdateDate": null,
  "errorMessage": null,
  "errorCode": null,
  "transactionStatusId": 1,
  "reversal": null
}

Örnek cURL

curl --location 'https://pgw.netahsilatdemo.com/vpws/transaction?referenceCode=NTH2P00000003086' \
--header 'Authorization: Bearer {AccessToken}'

Durum Kodları (transactionStatusId)

Kod	Açıklama
1	Başarılı
2	Başarısız
3	Beklemede

Notlar & En İyi Uygulamalar

• İşlem doğrulaması için mümkünse transactionId kullanılması önerilir.

• 3D işlemlerde OTP sonrası mutlaka bu endpoint ile son durum kontrol edilmelidir.

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

• İptal veya iade sonrası lastAmount güncellenmiş şekilde döner.

• paidTenantId alanı, işlemin hangi bayi tarafından gerçekleştirildiğini gösterir.

• Bayi yalnızca kendi işlemlerini sorgulayabilir.