Provizyon Kapatma

POST/partner/1.0/pos/transaction/capture

Gerekli scope: payment:saleIdempotency-Key zorunlu

Provizyonlu işlemle bloke edilen tutarı tahsil eder. Kapatma sonrası işlem COMPLETED olur ve para hesabınıza akmaya başlar.

amount boş bırakılırsa provizyonun tamamı kapatılır. Daha küçük bir tutar verirseniz kısmi kapatma yapılır: o tutar tahsil edilir, kalan bloke çözülür.

Örnek

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

İstek Body

Alan	Tip	Açıklama
`transactionRef`zorunlu	string	Ödeme yanıtındaki işlem referansı.
`amount`	decimal	Kapatılacak tutar. Boş veya 0 ise provizyonun tamamı kapatılır. Provizyon tutarını AŞAMAZ.
`description`	string	Kapatma açıklaması; 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.

Davranış

Sıra önce banka, sonra defter: banka kapatmayı reddederse işlem kaydında hiçbir şey değişmez.
Kısmi kapatmada işlem tutarı kapatılan tutara çekilir — kalan bloke bankada çözüldüğü için kayıtta da tahsil edilmiş görünmez.
Kapatma tek yönlüdür. Kapattığınız tutarı geri vermek için İade kullanın.
Kapatmadan vazgeçerseniz İptal ile blokeyi çözün.

Hatalar

Mesaj anahtarı	HTTP	Neden
`pos.transaction.not.pre.authorized`	406	İşlem provizyon durumunda değil (zaten kapatılmış, iptal edilmiş ya da hiç provizyon değil).
`pos.capture.exceeds.authorized`	406	Kapatma tutarı provizyon tutarını aşıyor.
`partner.api.amount.limit.exceeded`	406	Tutar, API anahtarınızın üst sınırını aşıyor.
`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*amountdescription