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

# Ödeme Yöntemleri ve Webhook Bildirim Sorunları

> Ödeme sonrası bakiye yüklenmemesi, Cloudflare WAF webhook engelleri, MoR (Creem/Paddle) avantajları ve API anahtarı eşleşmeleri.

Zonely üzerinde sanal POS (Shopier, PayTR, Weepay vb.) ve global Merchant of Record (Creem, Paddle) entegrasyonlarının sorunsuz çalışması; bildirim URL'lerinin (Webhook/Callback) doğru yanıt vermesine bağlıdır.

***

## En Sık Karşılaşılan Sorunlar ve Çözümleri

> [accordion] Ödeme başarılı yapılıyor fakat sitede bakiye/ürün otomatik teslim edilmiyor
>
> Ödeme kuruluşunun sitenize gönderdiği onay bildirimi (Webhook/Callback) siteniz tarafından alınamadığında veya engellendiğinde bakiye yüklenmez.
>
> * **1. HTTPS Protokolü Zorunluluğu:**
>   Tüm ödeme sağlayıcıları geri bildirim isteklerini güvenlik nedeniyle yalnızca `https://` protokolü üzerinden gönderir. Callback adresinizi tanımlarken başında `http://` kalmadığından emin olun.
>
> * **2. Cloudflare WAF veya Bot Koruması Engeli:**
>   Cloudflare kullanan sitelerde, Cloudflare'ın **WAF**, **Bot Fight Mode** veya **Under Attack Mode** özellikleri ödeme kuruluşunun webhook sunucularını şüpheli bot olarak algılayıp `HTTP 403 Forbidden` döndürebilir.
>   * **Çözüm:** Cloudflare -> **Security → WAF → Custom Rules** sekmesine gidin.
>   * `URI Path contains "/process/"` kuralını oluşturup eylemi **Bypass** (Tüm güvenlik özelliklerini atla) olarak kaydedin.
>
> * **3. Doğru Callback URL Formatı:**
>   Zonely'de her ödeme yöntemi için webhook adresi `/process/` öneki ile biter:
>   * Creem: `https://siteniz.com/process/creem`
>   * Paddle: `https://siteniz.com/process/paddle`
>   * Shopier: `https://siteniz.com/process/shopier`

> [accordion] Bireysel kullanıcıyım, şirket kurmadan yurt dışına satış yapabilir miyim?
>
> Evet, Zonely'nin desteklediği **MoR (Merchant of Record)** çözümleri (Creem ve Paddle) sayesinde bireysel sunucu sahipleri vergi levhası veya şirket kurma zorunluluğu olmadan uluslararası ödeme alabilir.
>
> * **MoR Nasıl Çalışır?** Creem ve Paddle, yasal olarak satıcı konumuna geçer; müşterinin ülkesindeki KDV/VAT vergilerini otomatik olarak hesaplayıp yerel vergi dairelerine öder. Size net kazancınızı doğrudan banka hesabınıza veya kripto cüzdanınıza aktarır.
> * **Creem:** Türk lirası ve global kartlar, Apple Pay, Google Pay desteği sunar.
> * **Paddle:** 200'den fazla ülkede yerel para birimleriyle ödeme almanızı sağlar.

> [accordion] API Anahtarı ile Client-side Token arasındaki fark nedir?
>
> Özellikle Paddle entegrasyonunda bu iki değerin karıştırılması yaygın bir hatadır:
>
> * **Canlı API Anahtarı (`pdl_live_apikey_...`):** Sunucunuzun Paddle API'leri ile arka planda güvenli konuşmasını sağlar. Yönetim panelinde *API Anahtarı* kutusuna girilmelidir.
> * **Client-side Token (`live_...`):** Kullanıcının tarayıcısında açılan ödeme penceresini (Paddle Checkout) tetikleyen genel anahtardır. *Client-side Token* kutusuna girilmelidir.
> * Bu iki anahtar yer değiştirdiğinde ödeme penceresi açılmaz veya satın alma onaylanamaz.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.