Bu sayfada
Drupal Commerce mağazanızı Paymos’a bağlayın
Drupal Commerce için Paymos modülünü kurun, projenizi bağlayın, Sandbox veya Live seçin; ödeme kontrollerini ve cron görevini ayarlayın.
Gereksinimler
Kararlı 1.0.0 sürümünü yüklemek için composer require drupal/commerce_paymos:^1.0 komutunu çalıştırın. Ardından mağazanızı Paymos'a bağlayıp ödeme yöntemini ekleyin.
Drupal ^10.3 || ^11 ve Commerce ^3 kullanın. Modül PHP ^8.1 ister; Drupal sürümünüz daha yeni bir PHP gerektiriyorsa Drupal'ın koşulunu esas alın. Mağazanızın herkese açık HTTPS adresi olmalıdır.
Modül, Drupal Commerce'e harici ödeme sayfasına yönlendiren yerel bir ödeme yöntemi ekler. Müşteriniz ödemek için mağazadan ayrılır; sipariş ve ödeme kayıtları Commerce'te kalır.
Modülü kurun
Öncelikli kurulum yolu Composer'dır. Drupal.org sürümü yayımlandıktan sonra Drupal projenizin dizininde şu komutu çalıştırın:
composer require 'drupal/commerce_paymos:^1.0'
Elle kurulum için GitHub sürümündeki ZIP paketini kullanın. PHP SDK pakete dahildir. commerce_paymos klasörünü üçüncü taraf modüllerin dizinine yerleştirin ve Drupal'da modülü etkinleştirin. Modülün lisansı GPL-2.0-or-later, SDK'nın lisansı MIT'dir. Elle kurulumda SDK dosyalarını paketten çıkarmayın.
Mağazayı bağlayın
Önce Paymos Panelini açıp mağazanız için kullanacağınız projeyi seçin. Ardından Drupal'da /admin/commerce/config/payment/paymos sayfasını açın ve Connect Paymos düğmesine basın. Onay bağlantısını açıp mevcut proje için bağlantıyı onaylayın. Drupal'a dönün ve Check approval düğmesine basın.
Ardından /admin/commerce/config/payment-gateways/add sayfasında ödeme yöntemi oluşturun. Paymos'u ve Sandbox ya da Live ortamını seçin. Mağazayı bağlamak ve Commerce ödeme yöntemini oluşturmak ayrı adımlardır; ikisini de tamamlayın.
Bağlantı bilgileri Drupal state içinde şifreli tutulur. Drupal'ın özel anahtarı ve hash_salt bu bilgileri korur; sırlar yapılandırma dışa aktarımına girmez. Mağazanın asıl URL'si değişirse yeniden bağlanın. /paymos/webhook bağlantı sırasında otomatik kaydedilir. Gizli bilgi girmeniz veya webhook'u elle oluşturmanız gerekmez.
Drupal yönetiminde gösterilen adresleri mevcut Paymos projenize bir kez kopyalayın: Success URL alanına /paymos/return, Fail URL alanına /paymos/return?cancel=1. Alıcı, ödeme sayfasındaki Back to store bağlantısıyla mağazaya döner. Dönüş adresleri aynı tarayıcı oturumunda bir saat saklanır ve yalnızca en son Paymos ödeme işlemine aittir. Oturum verileri yoksa, süresi dolmuşsa veya sipariş ya da ödeme ağ geçidi değişmişse mağazanın ana sayfası açılır. Tarayıcıdan dönüş, ödemeyi doğrulamaz. Ödeme durumu, doğrulanmış webhook/API verilerine ve Drupal Commerce ödeme kaydına bağlıdır.
Modülü güncelledikten sonra Drupal önbelleğini yeniden oluşturun: drush --uri=https://your-store.example cache:rebuild.
Ödemeleri kontrol edin
İmzalı bildirimin ardından API üzerinden doğrulama yapılır. Fatura; sipariş, proje, ortam, tutar ve para birimiyle eşleşmelidir. SQL işlemi Commerce'e tek bir tamamlanmış ödeme kaydeder. Aynı bildirim yeniden gelse de ikinci ödeme oluşmaz.
Eksik, gecikmiş veya bilgileri eşleşmeyen ödemelerde ürün otomatik teslim edilmez. Eşleşmeyen bilgileri inceleyin. Siparişin teslimini Commerce iş akışınız belirler; modül otomatik iade yapmaz.
Cron görevini çalıştırın
Drupal cron görevini düzenli çalıştırın. Görev, sonuçlanmamış faturaları sınırlı gruplar halinde kontrol eder. Drush'a mağazanızın asıl HTTPS adresini verin; örnekteki alan adını kendi adresinizle değiştirin:
drush --uri=https://your-store.example cron
Modülü kaldırın
Önce sonuçlanmamış faturaları çözün. Bu faturalar varken modül kaldırılamaz. Kaldırma işlemi yerel şifreli bağlantı bilgilerini siler; Commerce'in kendi ödeme kayıtlarını korur.
Başka bir platform için WooCommerce rehberine veya eklenti listesine bakın.