İşlem Detayı

POST/partner/1.0/pos/transaction/detail

Gerekli scope: payment:inquiry

Tek bir işlemin detayını getirir. 3DS akışında müşteri bankadan döndükten sonra kesin sonucu bu uçtan öğrenirsiniz.

Başka bir işletmenin işlemi yok gibi davranır — varlığını sızdıran ayrı bir hata kodu üretilmez.

Örnek

curl -X POST https://<host>/partner/1.0/pos/transaction/detail \
  -H "X-Api-Key: ..." \
  -H "X-Timestamp: ..." \
  -H "X-Signature: ..." \
  -H "Content-Type: application/json" \
  -d '{
  "transactionRef": "eb334ec5-9f7a-4c21-9b3e-77a01c4f2d18"
}'

İstek Body

Alan	Tip	Açıklama
`transactionRef`zorunlu	string	Ödeme yanıtındaki işlem referansı.

Yanıt

Alan	Anlamı
`transactionRef`	İşlem referansı. Sorgu, iptal ve iade hep bu değeri konuşur.
`orderNumber`	Ödemede gönderdiğiniz kendi sipariş numaranız.
`status`	İşlem durumu (`COMPLETED`, `PRE_AUTHORIZED`, `FAILED`, `PENDING_SETTLEMENT`, `SETTLED` …).
`phase` / `operation` / `channel`	İşlemin defterdeki aşaması, tipi ve geldiği kanal.
`amount`	Sipariş tutarı (komisyon hariç).
`chargedAmount`	Müşteriden tahsil edilen nihai tutar — komisyon müşteriye yansıyorsa `amount`tan farklıdır.
`netAmount`	İşletmenizin eline geçen net tutar.
`commissionAmount`	Hesaplanan komisyon tutarı.
`refundedAmount`	Bugüne kadar iade edilen toplam.
`currency` / `installment`	Para birimi ve taksit sayısı.
`threeDs`	İşlem 3D Secure'lü mü.
`refundable` / `voidable`	İşlem şu an iadeye / iptale açık mı.
`cardMasked` / `cardHolderName` / `cardBankName`	Maskeli kart numarası ve kart sahibi bilgileri. Tam PAN hiçbir uçtan dönmez.
`description`	İşlem açıklaması.
`providerReference` / `providerAuthCode`	Mutabakat için banka referans numarası (RRN/host-ref) ve banka onay kodu. Ham sağlayıcı gövdesi dışarı çıkmaz.
`createdDate` / `valorDate`	Oluşturma ve valör tarihi.

Hatalar

Mesaj anahtarı	HTTP	Neden
`paymenttransaction.not.found`	404	İşlem bulunamadı ya da işletmenize ait değil.

İsteği Dene

Önizleme modu — değerler kod örneklerini günceller, gerçek istek atılmaz.

Mock

transactionRef*