> ## Documentation Index
> Fetch the complete documentation index at: https://support.zonely.gen.tr/llms.txt
> Use this file to discover all available pages before exploring further.

# Ödeme Yöntemleri

> Tüm ödeme sağlayıcılarını, manuel ödeme içeriğini, komisyon davranışını ve callback kurulumunu yapılandırın.

# Ödeme Yöntemleri

**Ayarlar > Ödeme Yöntemleri** sayfasını açın.

## Sistem Nasıl Çalışır

Ödeme Yöntemleri sayfası, kullanıcılara ödeme ekranında gösterilen seçenekleri yönetir. Her ödeme yönteminde görünür başlık, altyapı sağlayıcısı, ödeme türü, sağlayıcı kimlik bilgileri, isteğe bağlı komisyon ayarları ve callback URL'si bulunur.

Sayfa iki bölümden oluşur:

* Başlık, API türü, yayın tarihi ve işlemleriyle birlikte mevcut ödeme yöntemleri listesi.
* Ödeme yöntemi eklemek veya düzenlemek için kullanılan çekmece formu.

Bir ödeme yöntemi kaydedildikten sonra sağlayıcı kimlik bilgileri doğruysa ve yöntem seçili ödeme akışıyla uyumluysa ödeme ekranında kullanılabilir.

## Ödeme Yöntemi Ekleme

1. **Ödeme Yöntemi Ekle** düğmesine tıklayın.
2. Kullanıcıların ödeme sırasında tanıyacağı **Başlığı** girin.
3. Sağlayıcı açılır listesinden **Altyapıyı** seçin.
4. **Türü** seçin. Bazı sağlayıcılarda tür otomatik olarak değişir.
5. Sağlayıcıya özel kimlik bilgisi alanlarını doldurun.
6. Panelin gösterdiği callback URL'sini kontrol edin.
7. Komisyonun müşteriye yansıtılıp yansıtılmayacağına karar verin.
8. Yöntemi kaydedin.
9. Herkese açmadan önce küçük bir ödeme ile test edin.

## Genel Alanlar

| Alan                       | Nasıl doldurulur                                                                                                                                      |
| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| Başlık                     | Ödeme yöntemi listesinde ve ödeme ekranında gösterilen ad. Kredi Kartı, PayPal, Banka Havalesi veya Manuel Ödeme gibi anlaşılır bir ad kullanın.      |
| Altyapı                    | Ödemeyi işleyecek sağlayıcıyı seçin. Her sağlayıcı kendi kimlik bilgisi alanlarını gösterir.                                                          |
| Tür                        | Ödeme kategorisini belirler. Çoğu sağlayıcı Kredi Kartı kullanır; bazıları Cüzdan kullanır; PayTR EFT Banka/EFT kullanır; Manuel ise Manuel kullanır. |
| Komisyonu müşteriye yansıt | Eklenen komisyonu müşterinin ödemesi gerekiyorsa etkinleştirin.                                                                                       |
| Komisyon oranı (%)         | Komisyon yansıtma etkinse eklenen yüzdelik komisyon.                                                                                                  |
| Sabit işlem ücreti         | Komisyon yansıtma etkinse eklenen sabit ekstra ücret.                                                                                                 |
| Callback URL               | Ödeme sonrasında sağlayıcının çağırması gereken URL. Panel bunu alan adınızda `/process/{provider}` olarak gösterir.                                  |

## Desteklenen Altyapılar

| Altyapı         | Tür                     | Zorunlu alanlar                                                                                                                 |
| --------------- | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| ZonelyPay       | Kredi Kartı             | Bir veya birden fazla ZonelyPay sağlayıcısı seçin, gerekiyorsa sağlayıcı e-postasını girin, sağlayıcı komisyonunu kontrol edin. |
| Tebex Checkout  | Kredi Kartı             | Tebex kullanıcı adı, Tebex özel anahtarı.                                                                                       |
| PayPal Checkout | Kredi Kartı veya Cüzdan | PayPal Client ID, PayPal secret.                                                                                                |
| Stripe          | Kredi Kartı             | API anahtarı, secret key, webhook key.                                                                                          |
| Coinbase        | Cüzdan                  | Secret key, webhook key.                                                                                                        |
| Iyzico          | Kredi Kartı             | API anahtarı, secret key, base URL.                                                                                             |
| PayTR           | Kredi Kartı             | Mağaza numarası, şifre, özel anahtar.                                                                                           |
| PayTR EFT       | Banka/EFT               | EFT için mağaza numarası, şifre, özel anahtar.                                                                                  |
| Shopier         | Kredi Kartı             | Shopier kullanıcı anahtarı, Shopier şifresi.                                                                                    |
| Vallet          | Kredi Kartı             | Kullanıcı, şifre, mağaza kodu, kriptografik hash.                                                                               |
| Shipy           | Kredi Kartı             | Shipy şifresi.                                                                                                                  |
| Freekassa       | Kredi Kartı             | Merchant ID, secret key 1, secret key 2, API anahtarı.                                                                          |
| WeePay          | Kredi Kartı             | WeePay ID, API anahtarı, secret key.                                                                                            |
| Zalopay         | Cüzdan                  | App ID, key 1, key 2.                                                                                                           |
| Paymes          | Kredi Kartı             | Public key, secret key.                                                                                                         |
| Paymes Mobile   | Cüzdan                  | Public key, secret key.                                                                                                         |
| Paywant         | Kredi Kartı             | API anahtarı, secret key.                                                                                                       |
| Paywant Mobile  | Cüzdan                  | API anahtarı, secret key.                                                                                                       |
| Square          | Kredi Kartı             | Access token, location ID.                                                                                                      |
| Momo            | Cüzdan                  | Partner code, access key, secret key.                                                                                           |
| Aaio            | Kredi Kartı             | Merchant ID, secret key 1, secret key 2, API anahtarı.                                                                          |
| Manual          | Manuel                  | Başlık ve içerik içeren bir veya daha fazla manuel içerik bloğu.                                                                |

## ZonelyPay Kurulumu

ZonelyPay diğer sağlayıcılardan farklı çalışır. Tek bir sağlayıcı anahtarı yazmak yerine panel bir sağlayıcı kataloğu yükler ve kullanmak istediğiniz ödeme sağlayıcılarını seçmenizi sağlar.

ZonelyPay'i yapılandırmak için:

1. Altyapı olarak **ZonelyPay** seçin.
2. Sunmak istediğiniz sağlayıcı kartlarını seçin.
3. Seçili sağlayıcı gerektiriyorsa e-posta/iletişim değeri ekleyin.
4. Her sağlayıcının komisyon oranını ve sabit ücretini kontrol edin.
5. Ek komisyonu müşterilerin ödemesi gerekiyorsa **Komisyonu müşteriye yansıt** seçeneğini etkinleştirin.
6. Ödeme yöntemini kaydedin.

Seçilen ZonelyPay sağlayıcıları birlikte saklanır. Hiç sağlayıcı seçilmemişse ödeme yöntemi kaydı mevcut olsa bile yöntem eksik görünebilir.

## Manuel Ödeme Kurulumu

Manuel ödeme, müşterinin otomatik çevrim içi ödeme tamamlamak yerine talimatları takip etmesi gerektiğinde kullanılır.

Manuel ödemeyi yapılandırmak için:

1. Altyapı olarak **Manuel** seçin.
2. Bir veya birden fazla manuel içerik bloğu ekleyin.
3. Her bloğa kısa bir başlık verin.
4. İçerik alanına ödeme talimatlarını yazın.
5. Gerekirse banka hesabı, IBAN, alıcı adı, açıklama formatı veya dekont talimatlarını ekleyin.
6. Yöntemi kaydedin.

Manuel ödemede ödeme bir sağlayıcı tarafından otomatik onaylanmadığı için callback ve komisyon alanları gizlenir.

## Sağlayıcı Notları

**PayTR ve PayTR EFT**

PayTR ve PayTR EFT ayrı kimlik bilgisi alanları kullanır. Kart ödemeleri için PayTR'yi, banka havalesi/EFT akışı için PayTR EFT'yi kullanın. Sağlayıcı hesabınız özellikle aynı değerleri kullanmanızı söylemedikçe normal PayTR kimlik bilgileriyle EFT'ye özel alanları karıştırmayın.

**Stripe ve Coinbase**

İkisi de webhook anahtarları kullanır. Ödeme durumunun siteye dönebilmesi için callback/webhook URL'sini sağlayıcı panelinde yapılandırın.

**PayPal**

PayPal panelde hem Kredi Kartı hem de Cüzdan türünü destekler. Müşterilerin yöntemi nasıl görmesini istiyorsanız o türe uygun seçim yapın.

**Zalopay, Momo, Paymes Mobile, Paywant Mobile ve Coinbase**

Bunlar cüzdan tarzı sağlayıcılardır. Ödeme ekranı metninin kullanıcılara hangi cüzdanı veya uygulamayı kullanacaklarını net şekilde anlattığından emin olun.

**Freekassa ve Aaio**

Bu sağlayıcılar birden fazla gizli değer ister. Her değeri karşılık gelen alana tam olarak kopyalayın.

**Tebex Checkout**

Tebex kullanıcı adı ve özel anahtar ister. Teslimat ve ödeme durumu harici Tebex kurulumuna da bağlı olduğu için kaydettikten sonra ödeme ekranını test edin.

## Ödeme Yöntemini Düzenleme

Mevcut bir ödeme yöntemini düzenlemek için satır işlemini kullanın. Çekmece; seçili altyapıyı, türü, kaydedilmiş değişkenleri, komisyon ayarlarını, manuel içeriği ve varsa ZonelyPay sağlayıcı seçimini geri yükler.

Düzenledikten sonra:

1. Yöntemi kaydedin.
2. Ödeme ekranını yenileyin.
3. Yöntemi tekrar test edin.
4. Sağlayıcı panelinde callback veya webhook URL'si kullanılıyorsa sağlayıcının hâlâ doğru callback adresine işaret ettiğini doğrulayın.

## Silme ve Sıralama

**Seçili olanları sil** işlemini yalnızca ödeme yöntemi artık kullanılmayacaksa kullanın. Emin değilseniz önce yöntemi düzenleyin veya ödeme ekranı görünürlüğünden kaldırın.

Liste sırasını değiştirdikten sonra **Değişiklikleri kaydet** işlemini kullanın. Sıra; tema ve ödeme sayfasına bağlı olarak ödeme yöntemlerinin yöneticilere veya kullanıcılara nasıl görüneceğini etkileyebilir.

## Sık Karşılaşılan Sorunlar

**Ödeme yöntemi kaydedildi ancak ödeme başarısız oluyor**

Kimlik bilgilerini, callback URL'sini, sağlayıcı paneli ayarlarını, para birimini ve sağlayıcı hesabının aktif olup olmadığını kontrol edin.

**Callback çalışmıyor**

Panelde gösterilen callback URL'sini kopyalayın ve sağlayıcı paneline ekleyin. URL alan adınızı ve `/process/{provider}` yolunu kullanmalıdır.

**Manuel ödeme talimatları görünmüyor**

Manuel altyapının seçildiğinden ve en az bir manuel içerik bloğunda başlık veya içerik bulunduğundan emin olun.

**ZonelyPay sağlayıcı göstermiyor**

Sağlayıcı kataloğu yüklenmemiş olabilir. Sayfayı yenileyin ve ZonelyPay sağlayıcı listesine ağ erişimini kontrol edin.

**Komisyon yanlış**

Hem sağlayıcı komisyonunu hem de genel komisyon alanlarını kontrol edin. **Komisyonu müşteriye yansıt** etkinse müşteri eklenen oranı veya ücreti görebilir.
