Ödeme Sorgula

Bir ödemenin nihai/kesin durumunu ve detayını sorgularsınız. 3D dönüşünde alıcının returnUrl’ine taşınan sonuç (kanal web (tarayıcı 303) ya da mobil (WebView) olsun), istemci üzerinden geldiği için nihai/güvenilir kabul edilmemelidir; kesin sonucu daima bu uçtan (ya da webhook) öğrenirsiniz. İki biçim vardır.

Koda göre

GET /v1/payments/{paymentCode}
Authorization: Bearer ptk_live_…

Partner işlem koduna göre

Kendi partnerTxCode’unuzla da sorgulayabilirsiniz (örn. webhook gelmeden önce durum kontrolü için):

GET /v1/payments?partnerTxCode=ORD-2026-8841
Authorization: Bearer ptk_live_…

Yanıt

200 OK:

{
  "paymentCode": "pay_7Hq2bL",
  "partnerTxCode": "ORD-2026-8841",
  "status": "captured",
  "amount": 125050,
  "currency": "try",
  "installmentCount": 3,
  "maskedPan": "4242 42** **** 4242",
  "cardFamily": "credit",
  "cardBank": "Örnek Bank",
  "appliedRateBps": 250,
  "appliedFixedFee": 25,
  "commissionAmount": 3151,
  "netToPartner": 121899,
  "expectedValueDate": "2026-06-16",
  "refunds": [],
  "createdAt": "2026-06-14T12:00:00Z",
  "updatedAt": "2026-06-14T12:05:11Z"
}

Alan	Açıklama
`paymentCode`	Paytalya ödeme kimliği.
`partnerTxCode`	Size ait işlem referansı.
`status`	Müşteri-görünür durum. Bkz. Ödeme Yaşam Döngüsü.
`amount`	Satış tutarı (kuruş).
`currency`	Para birimi.
`installmentCount`	Taksit sayısı (tek çekim için `1`).
`maskedPan`	Maskeli kart numarası; tam PAN asla dönmez. Henüz belirlenmemişse `null`.
`cardFamily`	Kart ailesi (varsa; yoksa `null`).
`cardBank`	Kartı çıkaran banka (varsa; yoksa `null`).
`appliedRateBps`	Uygulanan komisyon oranı, baz puan tamsayı (%2,5 → `250`). Hesaplanmadıysa `null`.
`appliedFixedFee`	Uygulanan sabit ücret (kuruş; varsa).
`commissionAmount`	Hesaplanan komisyon tutarı (kuruş; varsa).
`netToPartner`	Komisyon düşülmüş, size geçecek net tutar (kuruş; varsa).
`expectedValueDate`	Beklenen valör (hesaba geçiş) tarihi (varsa).
`refunds`	İade kalemleri listesi; her kalem `refundId`, `amount` (kuruş) ve `status` içerir. İade yoksa boş liste (`[]`).
`createdAt` / `updatedAt`	Zaman damgaları (UTC).