İçeriğe atlayın

Eklentiler

Bu sayfada

Magento 2 Eklentisi

Magento 2 veya Adobe Commerce için Paymos modülünü kurun, test ve canlı kimlik bilgilerini bağlayın ve siparişten faturaya durum akışını doğrulayın.

1. Gereksinimler

  • Magento Open Source veya Adobe Commerce 2.4.x ve komut satırı erişimi
  • Panelde seçili bir projesi olan Paymos hesabı
  • Modülün kendisi: Adobe Commerce Marketplace üzerinden Composer ile veya GitHub Releases üzerinden resmî ZIP ile

Resmî paketler her işyeri için aynıdır; API anahtarı, API secret'ı, proje ID'si, webhook secret'ı, OAuth token'ı veya cihaz kodu içermez.

2. Kurulum

Magento'nun yönetim panelinde eklenti yükleyicisi yoktur; iki yol da aynı konsol komutlarında sonlanır. Önce dosyaların nasıl geleceğini seçin.

Adobe Commerce Marketplace. Modül orada yayımlandığında Composer, modülü Paymos PHP SDK'sıyla birlikte tek komutla getirir:

composer require paymos/magento2-payment

Panelden ZIP. paymos-magento2-<version>.zip dosyasını GitHub Releases üzerinden veya Paymos panelindeki CMS entegrasyonu bölümünden alın ve Magento kök dizinine açın. Arşiv app/code/Paymos/Payment/… düzeninde gelir ve SDK içeride hazır taşınır; hiçbir şey taşınmaz ve Composer adımı gerekmez.

İki yol da aynı komutlarla tamamlanır:

bin/magento module:enable Paymos_Payment
bin/magento setup:upgrade
bin/magento setup:di:compile   # yalnızca production modunda
bin/magento cache:clean

setup:upgrade iki tablo oluşturur: sipariş başına bir anlık görüntü olan paymos_payment_invoice ve webhook tekilleştirme defteri olan paymos_payment_event. Ardından Stores → Configuration → Sales → Payment Methods → Paymos yolunu açın ve Connect Paymos'a tıklayın.

3. Bağlantı

  1. Paymos panelinde bağlamak istediğiniz projeyi açın. Eklenti o an seçili projeyi otomatik kullanır; size bir daha asla proje seçtirmez.
  2. Magento 2 içinde Connect Paymos'a tıklayın.
  3. Paymos'ta görüntülenen mağaza URL'sini ve mevcut projeyi onaylayın. İkinci bir proje seçici yoktur.
  4. Bağlandı durumu göründükten sonra CMS'e dönün.

Sandbox ve Live için Paymos, işyerinin tek etkin Payment anahtarını yeniden kullanır; yoksa bir tane oluşturur. Webhook'u yalnızca tam callback URL'si, Invoice kategorisi ve mevcut proje eşleştiğinde yeniden kullanır; aksi halde özel bir Invoice webhook'u oluşturur. Aynı URL'deki çakışan bir webhook asla sessizce üzerine yazılmaz:

https://your-store.example/paymos/payment/callback

OAuth cihaz yetkilendirmesi yalnızca tek seferlik teslimat kanalıdır. Kısa ömürlü token atılır; çalışma zamanı Merchant API çağrıları HMAC imzalı kalır.

4. Secret saklama

Kimlik bilgileri ve geçici cihaz durumu, Magento EncryptorInterface ve kurulumun şifreleme anahtarı üzerinden şifrelenmiş biçimde core_config_data içinde saklanır. Kaydedilen secret'lar yönetim sayfasına geri yansıtılmaz.

5. Test ve canlıya geçiş

Sandbox'ı seçin, bir test siparişi verin ve fatura ile webhook kaynaklı durum güncellemesini doğrulayın. Hazır olduğunuzda aynı kurulumu Live'a geçirin; yalnızca mağaza URL'sini değiştirdikten, bir Payment anahtarını iptal ettikten veya bir webhook secret'ını rotasyona aldıktan sonra yeniden bağlanın.

CS-Cart Eklentisi Shopware 6 Eklentisi