Checkout.com Modülü

11 görüntülenme Markdown

Checkout.com ile kart ödemelerini alın ve müşterilerin sonraki yenilemeler için kartlarını saklamasını sağlayın.

Ekrana Erişim

Ayarlar → Finansal → Ödeme Ağ Geçitleri yolunu izleyin, Tüm Modüller sekmesini açın ve Checkout.com kartına tıklayın: {admin}/modules/payment?module=CheckoutCom

Müşterilerin göreceği yöntemleri Ödeme Ağ Geçitleri ekranından yönetin.

Ekranda Neler Var

Modül kartında API anahtarları, webhook doğrulaması, işlem kanalı, ödeme yöntemi ve ortam ayarları bulunur.

Bu sürümün normal ödeme akışında sitenizin kart formu kullanılır. Müşteri ardından banka doğrulamasını tamamlayabilir. Kart saklama ve otomatik ödeme desteklenir; sağlayıcının yönettiği abonelik ve taksit sunulmaz.

Modülde ayrıca sağlayıcının ödeme sayfasına yönlendirme bulunur. İzin verilen yöntem listesi o sayfayı etkiler; normal kart formunu değiştirmez.

Ön Koşullar

Ülkeniz, para biriminiz ve ödeme yöntemleriniz için açık bir Checkout.com hesabı; denemeler için sandbox erişimi.
Aynı ortamdan genel ve gizli API anahtarları. Kart belirteci oluşturma, saklı kart yönetimi, ödeme oluşturma ve okuma ile iade yetkileri gerekir.
Ulaşılabilir bir HTTPS bildirim adresi ve o bildirimin imza anahtarı.

Alanlar

Gizli AnahtarZorunlu. Checkout.com'a giden ödeme, saklı kart ve iade isteklerini doğrular.

Genel AnahtarKart formu ve kart ekleme için zorunlu. Kart belirteci oluştururken kullanılır.

Webhook İmza AnahtarıBildirimler için zorunlu. Webhook kaydına ait imza anahtarını girin; API gizli anahtarıyla aynı değildir.

İşlem Kanalı KimliğiÖdemelerin kullanılacağı kanal. Hesabınız kanal seçimi gerektiriyorsa kimliğini girin; API anahtarlarının bu kanala izni olmalıdır.

İzin Verilen Ödeme Yöntemleriİsteğe bağlı, virgülle ayrılmış adlar: card, applepay, googlepay. Sağlayıcının ödeme sayfasını süzer. Boşsa hesaptaki tüm uygun yöntemler sunulur.

Otomatik Tahsil EtKayıtlı değer yoksa açık gelir. Kapalıyken provizyon faturayı ödendi yapmaz; ödemeyi Checkout.com'dan tahsil etmeniz gerekir.

Test ModuCanlı ortam yerine sandbox kullanır. Seçim; iki API anahtarı ve webhook kaydıyla aynı ortama ait olmalıdır.

Durum, komisyon, para birimi dönüştürme, tutar aralığı ve ülke listeleri için Ödeme Ağ Geçitleri makalesine bakın. Callback URL, Success URL ve Failed URL değerlerini WISECP verir.

İşlemler

API anahtarlarını oluşturma

Checkout.com panelinde Developers → Keys → Create a new key yolunu izleyin.
Test ortamı için genel ve gizli anahtar oluşturun. İşlem kanalına ve ön koşullarda belirtilen işlemlere izin verin.
Anahtarları kopyalayın. Developers → Keys bölümünde ilgili anahtarı açın ve bağlı işlem kanalının kimliğini alın.

Hesabı bağlama

Checkout.com modül kartında Durum kutusunu işaretleyerek ayarları açın.
Gizli Anahtar, Genel Anahtar ve gerekiyorsa İşlem Kanalı Kimliği alanlarını doldurun.
Sandbox anahtarları için Test Modu kutusunu işaretleyin. Hemen tahsilat için Otomatik Tahsil Et açık kalsın.
Değişiklikleri Kaydet butonuna tıklayın. Ayarlar kaydedilir; ödeme denemesinden önce bildirim kurulumunu tamamlayın.

Ödeme bildirimlerini kurma

Modül kartındaki Callback URL değerini kopyalayın.
Aynı Checkout.com ortamında Developers → Webhooks sayfasını açın ve bu HTTPS adresi için bir bildirim kaydı oluşturun.
payment_captured ile payment_declined ve payment_capture_declined gibi başarısız ödeme olaylarını ekleyin. Kaydı saklayın ve imza anahtarını kopyalayın.
Anahtarı Webhook İmza Anahtarı alanına girip Değişiklikleri Kaydet butonuna tıklayın. WISECP artık bu adrese gelen bildirimleri doğrulayabilir.

Müşteri ödemesini deneme

Müşteri olarak test siparişi başlatın veya ödenmemiş bir faturayı açıp Checkout.com yöntemini seçin.
Kart formuna Checkout.com test kartı girin. İstenirse banka doğrulamasını tamamlayın.
Checkout.com'daki işlemle WISECP faturasını kontrol edin. Tamamlanan tahsilat faturayı ödendi yapar; provizyon aşamasında fatura açık kalır.
Gerçek tahsilata geçerken iki anahtarı ve webhook kaydını canlı ortam değerleriyle değiştirin; Test Modu işaretini kaldırıp kaydedin.

Kart saklama ve yenilemeleri açma

Ödeme Ağ Geçitleri → Başlangıç Ayarları ekranına dönün. Kart Saklama Modülü alanında Checkout.com seçip Değişiklikleri Kaydet butonuna tıklayın.
Hesap sahibi müşteri hesabından kart ekleyebilir veya ödeme sırasında kartını saklayabilir. Kart eklenirken sıfır tutarlı doğrulama yapılır.
Müşteri Kayıtlı Kartlar bölümündeki kart menüsünden Otomatik Ödemeyi Aç seçer. Yenileme faturaları otomatik tahsilata alınabilir.
Başarılı yenileme ödemesi faturayı kapatır. Saklı kart silindiğinde Checkout.com'daki yeniden kullanılabilir kart kaydı da kaldırılır.

Faturayı iade etme

Ödenmiş faturayı açın: {admin}/invoices/detail?id={invoice}
Özet → Durumu Değiştir bölümünde İade Edildi ve Ödeme altyapısı ile iade seçin.
Durumu Güncelle butonuna tıklayın. Kabul edilen iade isteği faturayı günceller; iadenin tamamlandığını Checkout.com'dan kontrol edin.

Dikkat Edilecekler

Provizyon tahsilat değildir

Ödeme provizyonda beklerken başarı sayfası görünebilir. Hizmeti sunmadan önce fatura durumunu kontrol edin. Otomatik tahsilat kapalıysa ödemeyi Checkout.com'dan tahsil edin.

Ortamları ve imzaları birlikte değiştirin

Yanlış imza anahtarı bildirim doğrulamasını engeller. Dönüş sayfası da ödeme durumunu sorgulayabilir; fakat müşteri sayfayı kapatabilir. Güvenilir ödeme onayı için bildirimleri kurun.

İadeden önce tahsilat kaydını kontrol edin

Modül faturaya kaydedilmiş tutarı kullanır. Bu kayıt yokken ödeme kimliği bulunursa istek ödemenin tamamını iade edebilir. Tek ödemeyle birkaç fatura kapatılmışsa tutarı dikkatle kontrol edin.

Gerekli Yetkiler

Modül ayarları için Ödeme Modülü Ayarları (MODULES_PAYMENT_SETTINGS) yetkisi gerekir. İade ayrıca INVOICES_OPERATION ister.

Faydalı oldu mu?

Geri bildiriminiz için teşekkürler!

Hâlâ Yardıma mı İhtiyacınız Var?

Yukarıda bulamadığınız her şey için destek ekibimiz her zaman yanınızda.

Bize Ulaşın Destek Talebi Oluştur