Tahsilat Linkini İptal Et
POST
/partner/1.0/payment/link/cancelGerekli scope:
collection:linkHenü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 |
|---|---|---|
idzorunlu | 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 (tahsil edilecek) tutarı. |
cartAmount | Gönderdiğiniz sepet tutarı (kalem toplamı); amount'tan büyükse fark indirimdir. Gönderilmediyse boştur. |
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. |
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
PENDINGya daUNDER_REVIEWdurumundaki 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 zaten ödenmiş (COMPLETED), iptal edilmiş (REJECTED) ya da süresi dolmuş (EXPIRED). |
checkoutlink.not.found | 404 | Bu kimlikle bir link yok. |
user.not.related | 403 | Link 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.