Skip to main content
Mağazanız ödeme alabilmeden önce en az bir ödeme ağ geçidi bağlamanız gerekir. GurStore; Stripe, Iyzico ve Papara’yı kutudan çıktığı gibi destekler ve müşterilerinize daha fazla ödeme seçeneği sunmak için birden çok ağ geçidini aynı anda çalıştırabilirsiniz. Her ağ geçidi; ağ geçidi hesabınızdan API bilgilerini girmenizi, GurStore’un ödeme olaylarını alması için bir webhook URL’si kaydetmenizi ve ardından ağ geçidini yönetim panelinizde açmanızı gerektirir.

Ödeme Kurulumuna Erişim

Ödeme ağ geçitlerinizi yönetmek için Yönetim → Ödeme Kurulumu’na gidin. Bu sayfa; desteklenen tüm ağ geçitlerini, bağlantı durumlarını ve her birini etkinleştirme/devre dışı bırakma kontrollerini listeler.
GurStore, birden çok ödeme ağ geçidini aynı anda etkinleştirmeyi destekler. Müşteriler ödemede tüm aktif ağ geçitlerini seçenek olarak görür ve tercih ettikleri ödeme yöntemini seçebilir.

Stripe

Stripe; kredi kartlarını, banka kartlarını ve çok çeşitli yerel ödeme yöntemlerini destekleyen, küresel olarak kullanılabilen bir ödeme işlemcisidir.
1

Stripe API anahtarlarınızı alın

Stripe Panelinize giriş yapın, Developers → API Keys’e gidin ve Publishable key ile Secret key değerlerinizi kopyalayın.
2

Bilgilerinizi GurStore'a girin

Yönetim → Ödeme Kurulumu’nda Stripe bölümünü bulun ve Publishable Key ile Secret Key değerlerinizi ilgili alanlara yapıştırın.
3

Webhook URL'sini kaydedin

Stripe Panelinizde Developers → Webhooks’a gidin ve şu uç nokta URL’sini ekleyin:
Stripe’ın göndermesini istediğiniz olayları seçin (en az: payment_intent.succeeded, payment_intent.payment_failed, checkout.session.completed).
4

Stripe ağ geçidini etkinleştirin

Yönetim → Ödeme Kurulumu’nun Stripe bölümündeki Etkin anahtarını açın, ardından Kaydet’e tıklayın.
Stripe Secret Key’inizi asla herkese açık paylaşmayın veya sürüm kontrolüne eklemeyin. Gizli anahtarınıza erişimi olan herkes hesabınız adına API çağrıları yapabilir. Ona bir şifre gibi davranın.

Iyzico

Iyzico; Türk müşteriler için kredi kartlarını ve taksitli ödemeleri destekleyen, Türkiye’de yaygın bir ödeme ağ geçididir.
1

Iyzico API anahtarlarınızı alın

Iyzico Üye İş Yeri Paneline giriş yapın, Settings → API Keys’e gidin ve API Key ile Secret Key değerlerinizi kopyalayın.
2

Bilgilerinizi GurStore'a girin

Yönetim → Ödeme Kurulumu’nda Iyzico bölümünü bulun ve API Key ile Secret Key değerlerini ilgili alanlara yapıştırın.
3

Webhook URL'sini kaydedin

Iyzico Üye İş Yeri Panelinizde Settings → Webhook’a gidin ve şu URL’yi girin:
4

Iyzico ağ geçidini etkinleştirin

Yönetim → Ödeme Kurulumu’nun Iyzico bölümündeki Etkin anahtarını açın, ardından Kaydet’e tıklayın.
Iyzico Secret Key’iniz ödeme isteklerini imzalamak ve doğrulamak için kullanılır. Gizli tutun ve ele geçirildiğinden şüphelenirseniz hemen değiştirin.

Papara

Papara; müşterilerin Papara hesap bakiyeleriyle ödeme yapmasını sağlayan bir Türk dijital cüzdan ve ödeme hizmetidir.
1

Papara API anahtarınızı alın

Papara İş Hesabınıza giriş yapın, API Settings’e gidin ve API Key’inizi kopyalayın.
2

Bilgilerinizi GurStore'a girin

Yönetim → Ödeme Kurulumu’nda Papara bölümünü bulun ve API Key’inizi bilgi alanına yapıştırın.
3

Webhook URL'sini kaydedin

Papara üye iş yeri panelinizde Webhook Settings’e gidin ve şu URL’yi girin:
4

Papara ağ geçidini etkinleştirin

Yönetim → Ödeme Kurulumu’nun Papara bölümündeki Etkin anahtarını açın, ardından Kaydet’e tıklayın.
Papara API Key’inizi asla istemci tarafı kodda göstermeyin veya yetkisiz kişilerle paylaşmayın. Sızdığını düşünüyorsanız Papara panelinizden değiştirin.

Mağaza Para Biriminizi Ayarlama

Mağaza para biriminiz; fiyatların müşterilere nasıl gösterileceğini ve ödeme tutarlarının ağ geçidinize nasıl gönderileceğini belirler.
1

Yönetim → Ayarlar → Para Birimi bölümüne gidin

Kenar çubuğundaki Ayarlar menüsünü açın ve Para Birimi’ni seçin.
2

Para biriminizi seçin

Açılır listeden tercih ettiğiniz para birimini seçin (örneğin USD, EUR veya TRY).
3

Seçiminizi kaydedin

Kaydet’e tıklayın. Tüm ürün fiyatları ve ödeme toplamları artık seçilen para biriminde gösterilir.
GurStore’da seçtiğiniz para biriminin, ödeme ağ geçidi hesabınızda yapılandırılan para birimiyle eşleştiğinden emin olun. Bir uyumsuzluk ödeme hatalarına veya yanlış tahsilat tutarlarına yol açabilir.

Test Modu ve Canlı Mod

GurStore ödeme kurulumu hem test (sandbox) hem canlı modu destekler. Mağazanızı kurarken, gerçek işlem yapmadan ödemelerin doğru aktığını doğrulamak için test modunu kullanın.

Test Modu

Ağ geçidinizin sağladığı sandbox veya test API anahtarlarını kullanın. Ödemeler simüle edilmiş bir ortamdan geçer — gerçek para tahsil edilmez. Lansmandan önce ödeme akışınızı doğrulamak için idealdir.

Canlı Mod

Gerçek müşteri ödemelerini işlemek için üretim API anahtarlarınızı kullanın. Yalnızca ödeme akışınızı test modunda tamamen test ettikten sonra canlı moda geçin.
1

Sandbox bilgilerini girin

Yönetim → Ödeme Kurulumu’nda ağ geçidinizin sağladığı test veya sandbox API anahtarlarını bilgi alanlarına yapıştırın.
2

Bir test siparişi verin

Ödemenin doğru işlendiğini teyit etmek için ağ geçidinizin yayınladığı test kart numaralarını veya test hesabı bilgilerini kullanarak örnek bir sipariş verin.
3

Canlı bilgilere geçin

Memnun kaldığınızda sandbox anahtarlarını canlı üretim API anahtarlarınızla değiştirin ve kaydedin. Mağazanız artık gerçek ödemeleri kabul etmeye hazır.
Mağaza lansmanınızı duyurmadan önce tüm sandbox bilgilerini canlı bilgilerle değiştirdiğinizden emin olun. Test anahtarlarını yerinde bırakmak, gerçek müşteri ödemelerinin başarısız olmasına yol açar.