Tahsilat Linkini İptal Et

POST/partner/1.0/payment/link/cancel
Gerekli scope: collection:link

Henüz ödenmemiş bir tahsilat linkini iptal eder (durum REJECTED olur). Yalnızca kendi oluşturduğunuz linkleri iptal edebilirsiniz.

Örnek

curl -X POST https://<host>/partner/1.0/payment/link/cancel \
  -H "X-Api-Key: ..." \
  -H "X-Timestamp: ..." \
  -H "X-Signature: ..." \
  -H "Content-Type: application/json" \
  -d '{
  "id": "LINK-55012"
}'

İstek Body

AlanTipAçıklama
idzorunlustringİptal edilecek tahsilat linkinin kimliği.

Yanıt

AlanAnlamı
idLink kimliği. detail / cancel bu değeri alır.
paymentUrlMüşteriye göndereceğiniz ödeme adresi. Adresi kendiniz kurmanız gerekmez.
transactionRefLink ödendiğinde oluşan işlemin referansı; sorgu / iptal / iade zinciri buradan başlar. Ödenmemiş linkte boştur.
referenceNumberSistem üretimli referans numarası.
orderNumberSizin gönderdiğiniz sipariş numaranız.
amountLinkin toplam (tahsil edilecek) tutarı.
cartAmountGönderdiğiniz sepet tutarı (kalem toplamı); amount'tan büyükse fark indirimdir. Gönderilmediyse boştur.
paidAmount / remainingAmountTahsil edilen ve kalan tutar — kısmi ödemeye açık linklerde anlamlıdır.
currencyPara birimi.
statusLink durumu (PENDING, COMPLETED, REJECTED, EXPIRED, UNDER_REVIEW).
descriptionLink açıklaması.
allowPartialPaymentKısmi ödemeye açık mı.
enableInstallment / availableInstallmentsTaksit imkanı ve izin verilen taksit sayıları.
email / phoneCountryCode / phoneNumberAlıcı iletişim bilgileri.
expiryDate / completedDate / createdDateGeçerlilik, tamamlanma ve oluşturma tarihleri.
items[]Sepet kalemleri: productVariantId (katalog kaleminde), name, unitPrice (indirimli birim fiyat, KDV dahil), quantity, vat (KDV oranı %). Ürün gönderilmediyse alan dönmez.

Davranış

İptal, linki ödenemez hâle getirir: link hâlâ açılabilir ama ödeme adımı reddedilir.

  • Yalnız PENDING ya da UNDER_REVIEW durumundaki link iptal edilebilir. Ödenmiş linkte iptal yerine İade kullanılır.
  • Kısmi ödemeye açık bir linkte tahsil edilmiş tutar iptalle geri DÖNMEZ — iptal yalnız kalan tahsilatı durdurur, dönen tutar için iade gerekir.
  • İptal geri alınamaz; aynı tahsilat için yeni link oluşturmanız gerekir.
  • Süresi dolan link ayrıca iptal edilmez, kendiliğinden ödenemez olur.

Hatalar

Mesaj anahtarıHTTPNeden
checkout.link.status.invalid406Link zaten ödenmiş (COMPLETED), iptal edilmiş (REJECTED) ya da süresi dolmuş (EXPIRED).
checkoutlink.not.found404Bu kimlikle bir link yok.
user.not.related403Link başka bir işletmeye ait.

İsteği Dene

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