Ödeme entegrasyonu
PayTR
Ne yapar
- Kart ödemelerini PayTR'nin iframe ya da doğrudan modeliyle, 3D Secure üzerinden tahsil eder.
- Ödeme adımında taksit seçeneklerini döndürür ve seçilen taksit sayısını her ödemeye kaydeder.
- Bir sipariş durum değiştirmeden önce her PayTR bildiriminin imzasını doğrular; iadeleri API üzerinden yapar.
Sağlayıcının merkezi: Türkiye
PayTR, Kambloo'nun iki birincil kart ödeme yönteminden ikincisidir. Tek sözleşmeyle hızlı başlamak isteyen Türkiye'deki mağazaların sık tercihidir. Adaptör 3D Secure'u, taksitleri, saklı kartları ve API üzerinden iadeyi destekler. Kambloo'nun hiçbir ücret almadığı bir Dahili Modüldür.
Kambloo ile nasıl çalışır
PayTR iki 3D Secure modunda çalışabilir ve adaptör ikisini de karşılar. iframe modunda PayTR, Kambloo'nun ödeme sayfasına gömdüğü HTML içeriği döndürür. Doğrudan modda müşteri PayTR'ye yönlendirilir. Her iki durumda da kart numarası PayTR tarafında yazılır. Kambloo'nun sunucuları onu hiç görmez; böylece mağazanın PCI kapsamı SAQ-A seviyesinde kalır.
Sipariş beklemede durumunda oluşturulur ve ödeme başlamadan önce stok ayrılır. Banka yanıt verdiğinde PayTR, mağazanızın webhook adresine sunucudan sunucuya bir bildirim gönderir. Kambloo önce imzayı doğrular. Ancak ondan sonra ödeme satırını günceller, siparişi ödendi olarak işaretler ve müşteriyi onay sayfasına bırakır. Başarısız bir 3D Secure denemesi stok ayırmasını anında serbest bırakır ve müşteriyi sepete döndürür. Her yeni deneme yeni bir ödeme satırı olur; böylece geçmişin tamamı elinizde kalır.
Bildirimler birden çok kez gelebilir: tarayıcı dönüşü ve sunucu geri bildirimi ya da bir yeniden deneme. Kambloo buna karşı üç katman kullanır. Conversation ID üzerindeki bir önbellek kilidi eşzamanlı yinelenenleri sıraya alır. İşlem kimliğindeki benzersiz indeks ikinci bir kaydı engeller. Ödeme durum makinesi, tahsil edilmiş bir ödemeyi yeniden ilerletmeyi reddeder; böylece sipariş-ödendi olayı yalnızca bir kez tetiklenir. On dakika içinde hiçbir şey gelmezse bir sorgulama işi durumu PayTR'den ister.
Taksit seçenekleri ödeme adımında PayTR'den, kart BIN'ine ve sepet tutarına göre gelir. Hangi sayıların etkin olacağını ve farkın taksit başına gösterilip gösterilmeyeceğini siz belirlersiniz. Seçilen sayı ödeme kaydına yazılır.
Gerekenler
- Bir PayTR üye işyeri hesabı ve API bilgileri.
- Uçtan uca ilk sipariş için PayTR test modu.
- PayTR'nin bildirim adresinize ulaşabilmesi için yayında bir mağaza alan adı.
Kurulum adımları
Kısa sürüm. Mağaza yönetim panelinizdeki ekranlar aynı sırayı izler.
- PayTR modülünü Market'ten kurun. Ücretsizdir.
- PayTR API bilgilerinizi Ayarlar > Ödemeler > PayTR altına girin. Şifreli saklanır ve maskelenmiş gösterilir.
- iframe ya da doğrudan 3D Secure modunu seçin.
- PayTR'nin test modu açıkken bir test siparişi çalıştırın.
- Ödeme yöntemini etkinleştirin. Yapılandırma tamamlanınca ödeme adımında görünür.
PayTR hakkında sorular
iframe modunu mu doğrudan modu mu kullanmalıyım?
iframe modunda müşteri sizin ödeme sayfanızda kalır ve 3D Secure adımı bir çerçeve içinde açılır. Doğrudan mod PayTR'ye yönlendirir. Her iki modda da kart verisi PayTR tarafında kalır.
Tekrarlanan bir PayTR bildirimi ikinci bir ödeme kaydı oluşturabilir mi?
Hayır. Her bildirim ödeme yöntemi ve conversation ID üzerinde kilitlenir; işlem kimliği de ödemeler tablosunda benzersizdir. Yinelenen bildirimler onaylanır ve yok sayılır.
Bir siparişin yalnızca bir kısmını iade edebilir miyim?
Evet. Sipariş ekranından, iade edilebilir bakiyeye kadar herhangi bir tutarı iade edin. Talep PayTR'nin iade API'sine gider ve sonuç ödemeye işlenir.