Ödeme bağlantısı, işyerinin kendi ödeme sayfasını yazmadan tahsilat yapmasının yoludur: bir bağlantı üretirsiniz, müşteri açar, checkout gerisini halleder. Bağlantı SMS ile gönderilebilir, QR olarak bastırılabilir, TR Karekod olarak ödeme uygulamalarına okutulabilir.

​
Bağlantı oluşturma

Yanıttaki url alanı checkout adresidir: {CheckoutBaseUrl}/l/{slug}. Kurallar:
  • amountMinor boş bırakılabilir — açık tutarlı bağlantı olur; tutarı müşteri girer (bağış, serbest ödeme).
  • maxUsage: 0 sınırsızdır; 1 tek kullanımlık bağlantı yapar.
  • expiresAt Türkiye günü sonuna göre değerlendirilir.
  • Bağlantı silinmez; POST /v1/payment-links/{id}/disable ile kapatılır. Kapalı, süresi dolmuş ya da sınıra ulaşmış bağlantıyı açan müşteri nedenini açıkça görür.

​
Paylaşım kanalları

TR Karekod üretimi için şema tanımlayıcısı, üye işyeri numarası ve MCC gibi değerlerin POST /v1/karekod/settings ile (ya da paneldeki Ayarlar sayfasından) tanımlanması gerekir — bu değerler bankanızdan gelir, tahmin edilmez. Sabit tutarlı bağlantı dinamik, açık tutarlı bağlantı statik karekod üretir.

​
Sonuç neden sunucuda kapanır

Tarayıcı güvenilir bir aktör değildir: müşteri bankadan döndükten sonra sekmeyi kapatabilir. Para çekilmiş ama bağlantı “ödenmemiş” kalmış olurdu — tek kullanımlık bağlantı ikinci kez ödenebilirdi. Bu yüzden sonuç iki yoldan yazılır:
  1. Hızlı yol: müşteri sonuç sayfasını açtığında kullanım sayacı artar.
  2. Güvence yolu: iki dakikada bir çalışan arka plan işi, sonucu yazılmamış denemeleri ödeme defterinden kontrol eder ve tahsil edilmişleri kapatır.
Kullanım kaydının anahtarı ödeme kimliğidir: sayfa yenilense de, iki yol yarışsa da sayaç ödeme başına bir kez artar. Deneme kaydı ise ödeme oluşturulur oluşturulmaz, daha bankaya gidilmeden sunucuda yazılır — hangi ödemenin hangi bağlantıdan geldiği tarayıcının beyanına bırakılmaz.
Aynı bağlantı altyapısını saha tahsilatı da kullanır: temsilcinin cihazı bağlantı ister, sonucu yine sunucudaki iş kapatır.