Ö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
• Geliştirici ekibinin bu çeyrekte özel bir sepet bağlamayacağı satış sayfaları
• B2B takipler — bağlantıyı bir e-postaya yapıştır ve işi bitir
• “Bana bir kahve ısmarla” tarzı sabit-tutarlı bahşiş sayfaları

Bir tane oluşturun

Bugün bu yalnızca panel üzerinden mümkündür:

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

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 — duruma göre sayımlar, mevcut ortama göre kapsamlı (live vs test), X-Environment başlığı üzerinden, böylece sayılar her zaman 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. SDK, POST /b2b/v1/checkout-sessions/quick aracılığıyla eşdeğer tek kullanımlık oturumlar oluşturabilir (bkz. API referansı), ancak “uzun ömürlü paylaşılabilir URL” UX’i şu an yalnızca panel üzerinden.
• Alıcı başına kimlik doğrulama yok — URL’ye sahip herkes ödeyebilir. Tek kullanımlık model bunu kısmen hafifletir; tam alıcı kimlik bağlama aşağıdaki yol haritasında.
• 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ı henüz panel UI’sında sunulmuyor.

Yol haritası

İstediğimizi bildiğimiz öğeler, en yüksekten en düşüğe önceliklendirilmiş:

• Programatik oluşturma — panel’in iki sekmeli diyaloğunu yansıtan ve aynı checkout_url’yi döndüren bir POST /b2b/v1/payment-links uç noktası. Listeleme + iptal ile doğal olarak eşleşir.
• Zaman tabanlı son kullanma — bağlantı oturum TTL’i geçene kadar değil, belirli bir tarihe kadar geçerli kalır. “14 gün içinde vadesi dolar”ın doğal son tarih olduğu fatura akışları için gereklidir.
• Yeniden kullanılabilir bağlantılar — Stripe stili çoklu alıcı sayfaları (bağış, bahşiş, yinelenen hesap). Bugün her bağlantı tek kullanımlıktır.
• Alıcı başına kimlik — bir bağlantıyı belirli bir e-posta veya cüzdana kilitleyin, böylece yönlendirilemez.
• API tarafı QR oluşturma — panel bugün QR kodlarını istemci tarafında render eder; bunu etiket basımı ve gömülü makbuzlar için API üzerinde sunmak listede.

Ayrıca bakın

• Kavramlar → Oturumlar — bir alıcı ödeme yaparken oturum ve intent katmanında ne oluyor.
• Checkout → Genel bakış — alıcının fiilen ne gördüğü.
• Webhook’lar → Genel bakış — sunucunuzun tepki vereceği payment.settled event’i.