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

Alan	Tip	Açıklama
`id`zorunlu	string	İptal edilecek tahsilat linkinin kimliği.

Yanıt

Alan	Anlamı
`id`	Link kimliği. detail / cancel bu değeri alır.
`paymentUrl`	Müşteriye göndereceğiniz ödeme adresi. Adresi kendiniz kurmanız gerekmez.
`transactionRef`	Link ödendiğinde oluşan işlemin referansı; sorgu / iptal / iade zinciri buradan başlar. Ödenmemiş linkte boştur.
`referenceNumber`	Sistem üretimli referans numarası.
`orderNumber`	Sizin gönderdiğiniz sipariş numaranız.
`amount`	Linkin toplam tutarı.
`paidAmount` / `remainingAmount`	Tahsil edilen ve kalan tutar — kısmi ödemeye açık linklerde anlamlıdır.
`currency`	Para birimi.
`status`	Link durumu (`PENDING`, `COMPLETED`, `REJECTED`, `EXPIRED`, `UNDER_REVIEW`).
`description`	Link açıklaması.
`allowPartialPayment`	Kısmi ödemeye açık mı.
`enableInstallment` / `availableInstallments`	Taksit imkanı ve izin verilen taksit sayıları.
`email` / `phoneCountryCode` / `phoneNumber`	Alıcı iletişim bilgileri.
`expiryDate` / `completedDate` / `createdDate`	Geçerlilik, tamamlanma ve oluşturma tarihleri.

Davranış

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

Yalnız ödenmemiş 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ı	HTTP	Neden
`checkout.link.status.invalid`	406	Link bu işlem için uygun durumda değil (ödenmiş, iptal edilmiş ya da süresi dolmuş).
`checkout.notfound`	400	Link 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

id*