PayMongo Modülü

Filipinler'deki müşterilerinizden PayMongo ile ödeme alın: kart, dijital cüzdan, QR Ph ve çevrim içi bankacılık tek bir ödeme sayfasında toplanır.

Ekrana Erişim

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

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; PayMongo anahtarınızı, bildirim imza anahtarını, sunduğunuz yöntemleri ve iki görünüm ayarını taşır.

Müşteri ödeme adımında tutarı ve kullanılabilir yöntemleri gösteren bir PayMongo paneli görür. Butona tıklayınca PayMongo'nun kendi ödeme sayfası açılır, ödeme sonrası müşteri sitenize döner.

PayMongo yalnız Filipin pesosu ile tahsilat yapar; ödenecek tutar sayfa açılmadan önce pesoya çevrilir. İadeyi panelden gönderebilirsiniz. Abonelik, kart saklama, otomatik ödeme ve taksit desteklenmez.

Ön Koşullar

• Bir PayMongo hesabı ve panelde Settings → Product settings → Developers → API Keys yolundan okunan gizli anahtarı. Modu anahtarın kendisi belirler; ayrı bir test kutusu yoktur.
• Sunmayı düşündüğünüz her yöntemin PayMongo hesabınızda etkinleştirilmiş olması.
• Sisteminiz peso ile fiyatlamıyorsa, Filipin pesosunun (PHP) para birimi olarak tanımlı ve kurunun güncel olması.
• PayMongo panelinde Developers → Webhooks bölümüne erişim; bildirim adresini oraya kaydedersiniz.

Alanlar

Komisyon, kabul edilen tutar aralığı ve ülke listeleri her ağ geçidinde aynı çalışır: Ödeme Ağ Geçitleri. Para Birimi Dönüştürme alanı bu kartta yoktur; tutar PayMongo'ya her zaman peso olarak gider. Callback URL, Success URL ve Failed URL alanlarını değiştiremezsiniz; webhook olarak kaydettiğiniz adres callback adresidir.

İşlemler

PayMongo hesabınızı bağlama

1. PayMongo panelinde Settings → Product settings → Developers → API Keys sayfasını açın. İki anahtar çifti de orada listelenir; sk_test_ ile başlayanı kopyalayın.
2. Tüm Modüller altındaki PayMongo kartını açın ve Durum kutusunu işaretleyin.
3. Test anahtarınızı Gizli Anahtar alanına yapıştırın ve sunacağınız yöntemleri Ödeme Yöntemleri alanından seçin.
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 değerini kopyalayın.
2. PayMongo panelinde Developers → Webhooks bölümünü açın, Add endpoint butonuna tıklayın, adresi yapıştırın ve checkout_session.payment.paid olayını seçin.
3. Kaydettiğinizde uç noktanın imza anahtarı görünür. Bu değeri Webhook İmza Anahtarı alanına yapıştırın ve Değişiklikleri Kaydet butonuna tıklayın. Anahtarı sonradan uç noktanın Signing secret satırından tekrar okuyabilirsiniz.
4. Müşteri PayMongo sayfasındayken tarayıcısını kapatsa bile ödenen siparişler artık sonuçlanır.

Test ödemesi yapma

1. Müşteri olarak küçük tutarlı bir sipariş verin, PayMongo'yu seçin ve PayMongo ile Devam Et butonuna tıklayın.
2. PayMongo'nun test kartlarından ya da test cüzdanlarından biriyle ödeyin.
3. Müşteri sitenize döner, fatura ödendi olarak işaretlenir ve sipariş aktifleşir.
4. Anahtarı sk_live_ olanla değiştirin, canlı hesapta da webhook kaydedin ve küçük tutarlı gerçek bir ödemeyle tekrarlayın.

İade gönderme

1. Faturayı Fatura Detayı ekranından açın.
2. Durumunu iade edildi yapın, iade yöntemi olarak Ödeme altyapısı ile iade seçin ve onaylayın. Diğer iki seçenek yalnız kayıt tutar, PayMongo'ya bir şey göndermez.
3. Faturanın PayMongo ödemesindeki kendi payı müşteriye geri gider. Birden çok faturayı kapatan toplu ödemede iade, seçtiğiniz faturanın payıyla sınırlı kalır.

Dikkat Edilecekler

Gerekli Yetkiler

Ödeme Modülü Ayarları (MODULES_PAYMENT_SETTINGS) yetkisi gerekir.

İlgili Makaleler

• Ödeme Ağ Geçitleri
• Fatura Detayı
• Modül Yönetimi