<!-- Source: https://docs.infraio.xyz/tr/payment-links/overview -->
<!-- Last updated: 2026-10-04 -->

# Ödeme bağlantıları — Genel bakış

Bir **Ödeme bağlantısı**, bir alıcıyı önceden yapılandırdığınız bir
barındırılan checkout'a bırakan paylaşılabilir bir URL'dir. SDK yok, sunucu
entegrasyonu yok — panelde verin, paylaşın ve fonlar zincir üstünde
onaylandığında aynı `payment.settled` webhook'u tetiklenir.

Kaputun altında, bir Ödeme bağlantısı **bir** [CheckoutSession](https://docs.infraio.xyz/tr/concepts/sessions)
**dir** — "Ödeme bağlantısı" yalnızca alıcı tarafından yönlendirilen bir
SDK akışıyla oluşturulmamış bir oturumun panel tarafındaki adıdır. Aynı
webhook sözleşmesi, aynı zincir üstü tahsilat, aynı ücretler.

Yaygın kullanımlar:

- Kod yazmadan tek seferlik bir müşteriye fatura kesmek
- Özel bir sepetiniz olmayan satış sayfaları
- B2B takipler: bağlantıyı bir e-postaya yapıştırın
- "Bana bir kahve ısmarla" tarzı sabit-tutarlı bahşiş sayfaları

## Bir tane oluşturun

Ödeme bağlantılarını panelde oluşturun:

1. [Satıcı paneline](https://app.infraio.xyz) giriş yapın
2. **Ödemeler → Ödeme bağlantıları → + Yeni bağlantı**
3. İki yoldan birini seçin:
   - **Yeni sipariş** — line item'lar, para birimi, müşteri bilgisi ve
     opsiyonel metadata girin. Panel, Order'ı ve Ödeme bağlantısını tek
     bir çağrıda oluşturur.
   - **Mevcut sipariş** — bir `PENDING` siparişi seçin (örn.
     alıcı önceki bağlantıyı terk etti). Aynı sipariş tarafından
     desteklenen yeni bir bağlantı yeniden verir, böylece sipariş geçmişi
     bozulmadan kalır.
   - **New order** içinde **Yalnızca tutar** seçeneğine geçerek ürün listelemeden sabit bir tutar tahsil edebilirsiniz.
4. Kaydet → panel `https://checkout.infraio.xyz/cst_…` URL'sini bir
   kopyalama butonu ve indirilebilir bir QR kodu ile gösterir. Test modu
   bağlantıları `checkout-dev.infraio.xyz` kullanır, böylece ortam
   hostname'de kodlanır.

> **Note:**
>
> Her Ödeme bağlantısı bugün tek kullanımlıktır: bir alıcı ödediğinde,
> oturum `COMPLETED` durumuna geçer. Bir oturum ödeme öncesinde sona
> ererse (varsayılan TTL 30 dakikadır), sipariş detay sayfasını açın ve
> aynı siparişe karşı yeni bir tane vermek için **Bağlantıyı yeniden
> oluştur**'a tıklayın.

## Alıcı ne görür

1. `checkout.infraio.xyz/<session_key>` adresine inerler — SDK ile
   verilen bir oturumdan alacağınız aynı barındırılan checkout arayüzü.
2. [Checkout — Genel bakış](https://docs.infraio.xyz/tr/checkout/overview) sayfasında açıklanan
   standart varlık-seç → fon gönder → onay bekle akışından geçerler.
3. Webhook'unuzda `payment.settled` tetiklenir; sipariş, intent, makbuz,
   zincir üstü tx hash ve onay sayısı ile — diğer herhangi bir tahsil
   edilen ödeme ile aynı payload. Şema için bkz.
   [Webhook'lar](https://docs.infraio.xyz/tr/webhooks/overview).

## Panel size neler sunar

Ödeme bağlantıları yüzeyi bugün şunlarla birlikte gelir:

- **Liste görünümü** — verdiğiniz her bağlantı, cursor pagination ile,
  durum, tutar, üst sipariş numarası, müşteri, son kullanma ve alıcı
  URL'sine tek tıklamayla açılış.
- **Filtreler** — durum (`ACTIVE` / `COMPLETED` / `EXPIRED` / `CANCELED`),
  tarih aralığı ve sipariş numarası, müşteri adı, e-posta veya harici
  referans arası tam metin araması.
- **CSV dışa aktarma** — tek tık, mevcut filtrelere uyar.
- **KPI şeridi** — mevcut ortam (`live` veya `test`) için duruma göre
  sayımlar, tablonun gösterdiği ile eşleşir.
- **Detay sayfası** — sipariş özeti, oturum geçmişi (bu sipariş için her
  deneme), blok gezgini bağlantılarıyla zincir üstü geçmişi ve ödeme
  öncesinde sona eren oturumlar için **Bağlantıyı yeniden oluştur**
  eylemi.

## Bugünkü kısıtlamalar

- **Programatik API yok** — bağlantılar panelde oluşturulmalıdır.
  `POST /b2b/v1/checkout-sessions/quick` aracılığıyla eşdeğer tek
  kullanımlık oturumlar oluşturabilirsiniz (bkz. [API referansı](https://docs.infraio.xyz/tr/api-reference)),
  ancak paylaşılabilir bağlantılar yalnızca panelde oluşturulur.
- **Alıcı başına kimlik doğrulama yok** — URL'ye sahip herkes ödeyebilir.
  Her bağlantı tek kullanımlıktır, bu da riski sınırlar.
- **Branding globaldir** — bağlantı satıcı genelindeki logonuzu, marka
  renginizi ve **Ayarlar → Branding** üzerindeki kenarlık yarıçapını
  kullanır. Bağlantı başına branding geçersiz kılmaları
  kullanılamıyor.

## Ayrıca bakın

- [Kavramlar → Oturumlar](https://docs.infraio.xyz/tr/concepts/sessions) — bir alıcı ödeme
  yaparken oturum ve intent katmanında ne oluyor.
- [Checkout → Genel bakış](https://docs.infraio.xyz/tr/checkout/overview) — alıcının fiilen ne
  gördüğü.
- [Webhook'lar → Genel bakış](https://docs.infraio.xyz/tr/webhooks/overview) — sunucunuzun tepki
  vereceği `payment.settled` event'i.
