Revolut Modülü

18 görüntülenme Markdown

Revolut ile ödeme alın: müşteri ödemeyi Revolut'un kendi sayfasında tamamlar, isterse abonelik başlatır ya da yenilemeler için kart saklar.

Ekrana Erişim

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

Durum kutusunu işaretleyip kaydettiğinizde yöntem ödeme adımında listelenir. Müşterinin gördüğü sırayı Ödeme Ağ Geçitleri ekranından düzenleyin.

Ekranda Neler Var

Kart; Revolut Merchant API kimlik bilgilerinizi, ortam seçimini ve ortak ağ geçidi ayarlarını taşır.

Müşteri sepetin içinde kısa bir panel görür ve ödemeyi Revolut sayfasında tamamlar; kart bilgileri sitenize hiç ulaşmaz. Revolut sonucu Callback URL adresine bildirir.

Yenilenen kalemler, Revolut'un kendi takibinde tuttuğu bir abonelikle de ödenebilir. Kart saklanabilir ve sonra müşteri olmadan çekilebilir. Taksit desteklenmez.

Ön Koşullar

  • Satıcı hesabı tanımlı bir Revolut Business hesabı ve test için ayrı bir sandbox hesabı. İkisi hiçbir şeyi paylaşmaz: anahtarlar, müşteriler ve saklı kartlar ayrıdır.
  • Burada yapılandırdığınız ortama ait bir Merchant API gizli anahtarı.
  • Aynı satıcı hesabı için kaydedilmiş bir webhook; ödemeler ve abonelik dönemleri böyle bildirilir.
  • Revolut'un kabul ettiği bir para birimi. Fiyatlarınız başka bir para birimindeyse Para Birimi Dönüştürme alanını doldurun.

Alanlar

DurumModülü açar. Kapalıyken diğer alanlar kilitli kalır ve müşteriye bu yöntem sunulmaz.
Gizli API AnahtarıZorunlu. Revolut'a giden her isteği doğrulayan Merchant API gizli anahtarı.
Webhook İmza AnahtarıZorunlu. Revolut bunu webhook oluşturulurken bir kez verir. Anahtar olmadan gelen bildirimlerin hepsi reddedilir.
API Sürümüİsteklerin gönderileceği Revolut API sürümü; tarih biçiminde yazılır. Test ettiğiniz sürümü koruyun.
Test OrtamıTüm istekleri Revolut'un test ortamına gönderir; orada para geçmez. Varsayılan kapalı.
Abonelik Ücretinin GüncellenmesiHizmet fiyatı değiştiğinde Revolut'taki yinelenen tutarı da aynı hizaya getirir.

Komisyon, para birimi dönüştürme, kabul edilen tutar aralığı ve ülke listeleri her ağ geçidinde aynı çalışır: Ödeme Ağ Geçitleri. Callback URL, Success URL ve Failed URL alanlarını değiştiremezsiniz; bildirim adresini alanın sonundaki ikonla kopyalayın.

İşlemler

Revolut hesabınızı bağlama

  1. Sandbox hesabınızda Merchant overview → … → Merchant API → Generate yolunu açın ve gizli anahtarı kopyalayın.
  2. Tüm Modüller altındaki Revolut kartını açın ve Durum kutusunu işaretleyin.
  3. Anahtarı Gizli API Anahtarı alanına yapıştırın ve Test Ortamı kutusunu işaretleyin.
  4. Değişiklikleri Kaydet butonuna tıklayın. Yöntem artık ödeme adımında görünür.

Bildirim adresini kaydetme

  1. Modül kartındaki Callback URL adresini kopyalayın.
  2. Merchant API üzerinde POST /api/webhooks isteğinde adresi url olarak gönderin. Aynı hesabın gizli anahtarıyla kimlik doğrulayın.
  3. events listesine şunları ekleyin: ORDER_COMPLETED, ORDER_AUTHORISED, ORDER_CANCELLED, ORDER_FAILED, ORDER_PAYMENT_DECLINED ve ORDER_PAYMENT_FAILED.
  4. Yanıttaki signing_secret değerini Webhook İmza Anahtarı alanına yapıştırın ve Değişiklikleri Kaydet butonuna tıklayın. Bildirimler artık doğrulanabilir.

Test ödemesi yapma

  1. Müşteri olarak küçük tutarlı bir sipariş verin ve ödeme adımında Revolut'u seçin.
  2. Revolut'a Devam Et butonuna tıklayın ve sandbox test kartıyla ödeyin.
  3. Siteye dönersiniz. Fatura ödendi olarak işaretlenir ve sipariş aktifleşir.

Canlıya geçme

  1. Gizli anahtarı üretim Revolut Business hesabınızda üretin ve webhook'u orada da kaydedin.
  2. Gizli API Anahtarı ve Webhook İmza Anahtarı alanlarını üretim değerleriyle değiştirin.
  3. Test Ortamı işaretini kaldırın ve kaydedin. Testi küçük tutarlı gerçek bir ödemeyle yineleyin.

Müşterinin abonelik başlatmasına izin verme

  1. Müşteri sepetteki panelden yenilenen kalemleri seçer ve tek seferlik ödeme yerine aboneliği seçer. Seçilen kalemlerin faturalama döngüsü aynı olmalıdır.
  2. Revolut aboneliği oluşturur, ilk ödemeyi alır ve sonraki dönemleri kendisi çeker.
  3. Anlaşma Abonelikler ekranında listelenir, iptali de oradan yaparsınız. Yinelenen tutarın hizmet fiyatını izlemesi için Abonelik Ücretinin Güncellenmesi kutusunu işaretleyin.

Saklı kart ve otomatik ödeme sunma

  1. Ödeme Ağ GeçitleriBaşlangıç Ayarları → Kart Saklama Modülü alanında Revolut seçin ve kaydedin.
  2. Müşteri kendi hesabından kart ekler ve bilgileri açılan Revolut formuna girer.
  3. Müşteri Kayıtlı Kartlar bölümündeki kart menüsünden Otomatik Ödemeyi Aç seçer. Yenileme faturaları otomatik tahsilata alınabilir.

İade gönderme

  1. Faturayı Fatura Detayı ekranından açın.
  2. Ö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.
  3. Revolut bu fatura için kaydedilen tutarı geri gönderir.

Dikkat Edilecekler

Bildirimler imza anahtarını gerektirir

Eksik veya yanlış anahtar webhook bildirimlerini reddettirir. Tarayıcı dönüşü ödemeyi API üzerinden doğrulayabilir, ancak müşteri siteye dönmeyebilir. Abonelik dönemleri için bildirimlerin çalışması gerekir.

Sandbox ve üretim iki ayrı hesaptır

Sandbox anahtarı para tahsil etmez ve üretimde reddedilir. Sandbox'ta oluşan saklı kartlar ve abonelikler canlı tarafta yoktur. Anahtarı, imza anahtarını ve Test Ortamı seçimini birlikte değiştirin.

Abonelik tutarını güncelleyin

Abonelik Ücretinin Güncellenmesi kapalıyken hizmet fiyatı değişse de Revolut eski tutarı tahsil eder. İptali Abonelikler ekranından yönetin.

Gerekli Yetkiler

Ayarlar için Ödeme Modülü Ayarları (MODULES_PAYMENT_SETTINGS) gerekir. Fatura değişiklikleri için Faturalandırma → Düzenleme (INVOICES_OPERATION) gerekir.

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.