İşlem İptali

POST/partner/1.0/pos/transaction/cancel

Gerekli scope: payment:void

Henüz mahsuplaşmamış bir ödeme tahsilatını iptal eder (void). Açık provizyonun blokesini de bu uç çözer.

Tahsilat linki veya karekod ile alınan ödemelerde de çalışır — o akışlarda ters kayıt doğrudan ödeme motorundan geçer.

Örnek

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

İstek Body

Alan	Tip	Açıklama
`transactionRef`zorunlu	string	Ödeme yanıtındaki işlem referansı.
`reason`	string	Opsiyonel iptal gerekçesi; işlem kaydına yazılır.

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
`checkout.already.captured`	406	Tahsil edilmiş işlem iptal edilemez; iade kullanın.
`pos.reversal.rejected.by.provider`	406	Sağlayıcı iptali reddetti; ret gerekçesi mesajda yer alır.
`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*reason