# PayMongo Modülü

https://docs.wisecp.com/tr/paymongo-modulu

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](https://docs.wisecp.com/tr/odeme-modulleri) 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

- **Durum**: Modülü açar. Kapalıyken diğer alanlar kilitli kalır ve müşteriye bu yöntem sunulmaz.
- **Gizli Anahtar**: Tahsilat için zorunlu. Test kipinde `sk_test_`, canlı kipte `sk_live_` ile başlar; form başka bir biçimi kabul etmez.
- **Webhook İmza Anahtarı**: PayMongo'nun webhook oluştururken gösterdiği imza anahtarı. `whsk_` ile başlar ve bildirimin gerçekten PayMongo'dan geldiğini kanıtlar.
- **Ödeme Yöntemleri**: PayMongo sayfasında sunulan yöntemler. Kart, GCash, QR Ph, Maya, GrabPay, ShopeePay, BillEase ve BPI, UnionBank, BDO, Landbank, Metrobank çevrim içi bankacılığı seçilebilir. En az bir yöntem seçili kalmalı; kurulumla gelen küme kart, GCash ve QR Ph'dir.
- **E-posta Makbuzu**: Başarılı ödemeden sonra PayMongo'nun kendi makbuzunu müşteriye e-postayla göndermesini sağlar. Sizin fatura e-postanız her hâlde gider.
- **Ekstre Açıklaması**: İsteğe bağlı, en çok 255 karakter. Müşterinin kart ya da banka ekstresinde görünen metin. Boş bırakırsanız PayMongo hesabınızın adı görünür.

Komisyon, kabul edilen tutar aralığı ve ülke listeleri her ağ geçidinde aynı çalışır: [Ödeme Ağ Geçitleri](https://docs.wisecp.com/tr/odeme-modulleri). **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ı](https://docs.wisecp.com/tr/fatura-detayina-genel-bakis) 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

> **Modu anahtarın öneki belirler**
> 
> `sk_test_` anahtarıyla yapılan ödeme faturayı ödendi yapar ama para geçmez. Kayıtlı anahtarın modundan farklı bir bildirim yok sayılır; anahtarı ve webhook'u birlikte değiştirin.

> **Boş imza anahtarı denetimsiz bildirim kabul eder**
> 
> **Webhook İmza Anahtarı** boşken gelen bildirimler doğrulanmadan işlenir. Webhook'u oluşturur oluşturmaz bu alanı doldurun.

> **Eksik tahsilat faturayı açık bırakır**
> 
> PayMongo ödenecek tutardan azını tahsil ederse fatura ödenmemiş kalır ve müşteri bir hata görür. Elle kapatmadan önce tutarı PayMongo panelinizden karşılaştırın.

## Gerekli Yetkiler

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

## İlgili Makaleler

- [Ödeme Ağ Geçitleri](https://docs.wisecp.com/tr/odeme-modulleri)
- [Fatura Detayı](https://docs.wisecp.com/tr/fatura-detayina-genel-bakis)
- [Modül Yönetimi](https://docs.wisecp.com/tr/modul-yonetimi)