Tahsilat Linki Detayı

POST/partner/1.0/payment/link/detail

Gerekli scope: collection:link

Bir tahsilat linkinin durumunu ve detayını döner. Yalnızca kendi oluşturduğunuz linkleri görüntüleyebilirsiniz.

Link ödendiğinde transactionRef dolar — ödemenin sorgu, iptal ve iade zinciri işlem uçlarından yürür.

Örnek

curl -X POST https://<host>/partner/1.0/payment/link/detail \
  -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	Tahsilat linki 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.

Hatalar

Mesaj anahtarı	HTTP	Neden
`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*