Skip to Content
Ödeme bağlantılarıGenel bakış
View as Markdown

Ö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 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  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.

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ış 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.

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ı), 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

Genel bakışShopify