# Mercado Pago Modülü

https://docs.wisecp.com/tr/mercado-pago-modulu

Mercado Pago ile ödeme alın: müşteri ödemeyi Mercado Pago'nun kendi sayfasında tamamlar, isterseniz abone olarak yenilemelerini de otomatik ödeyebilir.

## Ekrana Erişim

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

**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; Mercado Pago erişim anahtarını, ödeme sayfası seçeneklerini ve ortak ağ geçidi ayarlarını taşır.

Ödeme adımında Mercado Pago, **Mercado Pago ile Devam Et** butonunu taşıyan bir kutu olarak görünür. Müşteri ödemeyi Mercado Pago sayfasında tamamlar ve geri döner. Sonuç bir bildirimle doğrulanır ve fatura kapanmadan önce Mercado Pago'dan yeniden okunur.

**Abonelik** açıkken yenilenen kalemli siparişte **Abone ol ve otomatik öde** seçeneği de sunulur. Taksit seçimi Mercado Pago sayfasında yapılır. Kart saklama, kayıtlı kartla otomatik ödeme ve site içinde kart formu desteklenmez.

## Ön Koşullar

- Bir Mercado Pago hesabı ve uygulaması. Mercado Pago Developers üzerinde oturum açın, **Your integrations** butonuna tıklayın ve uygulamanız yoksa bir tane oluşturun.
- Test kimlik bilgileri uygulama oluşur oluşmaz hazırdır. Canlı kimlik bilgilerinin tahsilat yapabilmesi için işletme bilgilerinizle etkinleştirilmesi gerekir.
- Mercado Pago'nun ülkenizde kabul ettiği bir para birimi. Fiyatlarınız başka bir para birimindeyse **Para Birimi Dönüştürme** ayarını girin.

## Alanlar

- **Durum**: Modülü açar. Kapalıyken yöntem müşteriye hiç sunulmaz.
- **Erişim Anahtarı**: Zorunlu. Uygulamanızın erişim anahtarı. `TEST-` ile başlayan anahtar test kimlik bilgileriyle çalışır; canlı anahtar gerçek para tahsil eder.
- **Bildirim İmza Anahtarı**: Mercado Pago'nun uygulamanız için ürettiği imza. Girildiğinde imzalı her bildirim doğrulanır, uyuşmayan reddedilir. Boş bırakıldığında bildirimler bu denetim olmadan kabul edilir.
- **Ekstre Açıklaması**: Müşterinin kart ekstresinde görünen, en fazla 13 karakterlik açıklama.
- **Yalnızca Anlık Sonuç**: Varsayılan kapalı. İşaretlendiğinde yalnızca onaylanan ya da reddedilen ödemeler kabul edilir. Kapalıyken ödeme incelemeye de düşebilir ve fatura inceleme bitene kadar bekler.
- **Azami Taksit Sayısı**: Ödeme sayfasında sunulacak en yüksek kart taksit sayısı. Boş bırakılırsa kararı Mercado Pago verir.
- **Hariç Tutulan Ödeme Tipleri**: Ödeme sayfasında gizlenecek ödeme tipleri, virgülle ayrılır: `ticket` ya da `bank_transfer` gibi. Boş bırakılırsa hesabınızın desteklediği tüm yöntemler sunulur.
- **Ödeme Süresi (Dakika)**: Ödeme sayfasının açıldıktan sonra kaç dakika ödenebilir kalacağı. Boş bırakılırsa süre sınırı olmaz.
- **Abonelik**: Varsayılan kapalı. İşaretlendiğinde müşteri tek seferlik ödeme yerine abone olabilir ve yenilemeleri Mercado Pago tahsil eder.
- **Abonelik Ücretinin Güncellenmesi**: Hizmet fiyatı değiştiğinde Mercado Pago tarafındaki yinelenen tutarı aynı değere getirir.
- **Bildirim Adresi**: Değiştirilemez. Bu adresi Mercado Pago uygulamanızın bildirim ayarlarına kopyalayın.

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](https://docs.wisecp.com/tr/odeme-modulleri) makalesine bakın. **Callback URL**, **Success URL** ve **Failed URL** değiştirilemez.

## İşlemler

### Mercado Pago uygulamanızı bağlama

1. Mercado Pago Developers üzerinde **Your integrations** butonuna tıklayın ve uygulamanızı açın. Sol menüden **Testing > Test credentials**, kimlik bilgilerini etkinleştirdiyseniz **Production > Production credentials** bölümünü seçin.
2. Orada görünen **Access Token** değerini kopyalayın.
3. **Tüm Modüller** altındaki Mercado Pago kartını açın, **Durum** kutusunu işaretleyin ve anahtarı **Erişim Anahtarı** alanına yapıştırın.
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 **Bildirim Adresi** değerini kopyalayın.
2. Uygulamanızda **Webhooks > Configure notifications** bölümünü açın ve adresi canlı adres alanına, test aşamasındayken test adres alanına da yapıştırın.
3. **Payments** olayını işaretleyin. Abonelik sunacaksanız **Plans and Subscriptions** olayını da ekleyin ve **Save** butonuna tıklayın.
4. Aynı ekranda imza anahtarını görünür yapın, **Bildirim İmza Anahtarı** alanına yapıştırın ve **Değişiklikleri Kaydet** butonuna tıklayın. Ödeme sonuçları artık faturaya kendiliğinden ulaşır.

### Test ödemesi yapma

1. Müşteri olarak küçük tutarlı bir sipariş verin ve ödeme adımında Mercado Pago'yu seçin.
2. **Mercado Pago ile Devam Et** butonuna tıklayın ve ödemeyi Mercado Pago sayfasında tamamlayın.
3. Siteye geri dönersiniz, fatura ödendi olarak işaretlenir ve sipariş etkinleşir.
4. Test anahtarını canlı anahtarla değiştirin ve düşük tutarlı gerçek bir ödemeyle tekrarlayın.

### Abonelik sunma

1. Modül kartında **Abonelik** kutusunu işaretleyin ve **Değişiklikleri Kaydet** butonuna tıklayın.
2. **Webhooks > Configure notifications** bölümünde **Plans and Subscriptions** olayını yukarıdaki gibi kaydedin.
3. Uygun siparişlerde **Abone ol ve otomatik öde** görünür. Tüm kalemlerin dönem birimi ve aralığı aynı olmalıdır. Bugünkü toplam yinelenen tutara eşit olmalıdır; kurulum ücreti, tek seferlik kalem veya indirim seçeneği gizleyebilir.
4. Mercado Pago ilk tahsilatı onaydan sonra, yenilemeleri otomatik yapar. İptali [Abonelikler](https://docs.wisecp.com/tr/abonelikler) ekranından yönetin.

### İade gönderme

1. Faturayı [Fatura Detayı](https://docs.wisecp.com/tr/fatura-detayina-genel-bakis) 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. Onaylayın. İade Mercado Pago'ya gönderilir ve para ödeyene geri döner.

## Dikkat Edilecekler

> **Test anahtarı tahsilat yapmaz**
> 
> `TEST-` anahtarıyla yapılan ödemeler faturayı ödendi işaretler ve siparişi etkinleştirir. Para hareket etmez. Yöntemi müşterilere açmadan önce canlı anahtarı girin.

> **Abonelik yenilemesi kendi olayını ister**
> 
> Abonelik sözleşmesinin kendine ait bir bildirim adresi yoktur. Webhooks altında **Plans and Subscriptions** kayıtlı değilse Mercado Pago'nun tahsil ettiği yenileme buraya hiç bildirilmez. Müşteriden para çekilir, sipariş ödenmemiş kalır. Olayı **Abonelik** kutusunu işaretlemeden önce kaydedin.

> **Yanlış imza bildirimleri durdurur**
> 
> **Bildirim İmza Anahtarı** uyuşmazsa imzalı bildirimler reddedilir ve faturalar açık kalabilir. İmzayı yenilediğinizde güncel değeri modüle kopyalayın.

## 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.

## İlgili Makaleler

- [Ödeme Ağ Geçitleri](https://docs.wisecp.com/tr/odeme-modulleri)
- [Fatura Detayı](https://docs.wisecp.com/tr/fatura-detayina-genel-bakis)
- [Abonelikler](https://docs.wisecp.com/tr/abonelikler)