Skip to main content
Macaly’nin Stripe entegrasyonu, projenizde doğrudan tek seferlik ve tekrarlayan (abonelik) ödemeler almanızı sağlar. Tamamen çalışan bir test ortamı otomatik olarak sağlanır, böylece bir Stripe hesabı olmadan oluşturmaya ve test etmeye başlayabilirsiniz. Canlıya geçmeye hazır olduğunuzda Stripe hesabınızı bağlayın ve canlı moda geçin.
Pro ve Ajans planlarında kullanılabilir

​
Projenize ödeme ekleme

Ödeme ihtiyaçlarınızı sohbette agent’a tarif edin. Örneğin:
Agent, tam bir ödeme akışıyla projenizi oluşturur ve arka planda bir Stripe test ortamı sağlar. Ödeme eklemek için üst gezinme çubuğundaki Ödemeler sekmesinden de başlayabilirsiniz. Ödemeler sekmesinde gösterilen test kartını kullanarak hemen test etmeye başlayabilirsiniz: Projenize gidin, bir test satın alması tamamlayın ve ödeme deneyimini doğrulayın.
Stripe’ın özel test kartlarını kullanarak reddedilen kartlar veya geçersiz ödeme verileri gibi hata senaryolarını da test edebilirsiniz. Test kartı numaralarının ve simüle ettikleri hataların tam listesi için Stripe’ın test dokümantasyonuna bakın.

​
Güvenli test alanınızı etkinleştirme

Macaly test ortamınızı oluştururken bir Stripe sandbox sağlar. Bu sandbox hemen çalışır ve ödemeleri test etmenize izin verir, ancak herhangi bir Stripe hesabına bağlı değildir. Sahiplenilmemiş sandbox’lar 60 gün sonra sona erer. Sandbox’ı sahiplenmek onu Stripe hesabınıza bağlar. Sahiplenildikten sonra sandbox sizindir ve onu doğrudan Stripe Dashboard’unda yönetebilirsiniz. Sandbox’ı iki şekilde sahiplenebilirsiniz: projenizdeki Ödemeler sekmesinden veya test ortamı oluşturulduktan sonra Stripe’ın size gönderdiği e-posta üzerinden. Sahiplenme aynı zamanda gerçek ödemeler kabul etmenin ilk adımıdır. Canlıya geçmek için sandbox’ı sahiplenmeniz, işletmenizi Stripe ile doğrulamanız ve canlı API anahtarlarınızı girmeniz gerekir.
1

Ödemeler sekmesini açın

Projenizdeki Ödemeler sekmesini açın. “Güvenli test alanınızı etkinleştirin” altında bir Stripe sandbox’ınızı sahiplenin düğmesi göreceksiniz.
2

Stripe sandbox'ınızı sahiplenin'e tıklayın

Stripe, yeni bir sekmede Sandbox’ınızı sahiplenin sayfasıyla açılır.Mevcut bir Stripe hesabınız varsa listeden seçin. Yoksa, ücretsiz bir hesap oluşturmak için + Yeni hesap oluştur’a tıklayın.Devam etmek için Devam et’e tıklayın.
3

İşletme bilgilerinizi girin

Stripe size bazı temel bilgiler soracaktır:
  1. İşletme adı ve konumu. İşletmenizin adını girin ve ülkenizi seçin. Devam et’e tıklayın.
  2. İşletme web sitesi ve açıklaması. Web sitenizin URL’sini ve ürün veya hizmetlerinizin kısa bir açıklamasını girin. Bu adım Atla’ya tıklayarak geçilebilir.
  3. Stripe’ı kullanım amacınız. İşletmenizle ilgili ödeme türlerini seçin (ör. tek seferlik veya tekrarlayan ödemeler). Bu adım da atlanabilir.
4

Sandbox kurulumunu tamamlayın

Son ekranda Stripe, sonraki adımların bir özetini sunar: kurulumunuzu tamamlayın, canlı moda geçin ve ödeme almaya başlayın. Bitirmek için Sandbox’a git’e tıklayın.
5

Macaly'ye dönün

Macaly’ye geri gidin. Ödemeler sekmesi artık turuncu renkte Ödemeler Test modunda göstermeli, bu da sahiplenmenin başarılı olduğunu doğrular.
Durum güncellemelerinin senkronize olması birkaç dakika sürebilir. Sahiplenme düğmesi hâlâ görünüyorsa sayfayı yenileyin.

​
Canlı moda geçme

Gerçek ödemeler kabul etmeye hazır olduğunuzda, Stripe hesabınızı etkinleştirmeniz ve canlı API anahtarlarınızı Macaly’ye bağlamanız gerekir.
Projeniz aracılığıyla kabul ettiğiniz ödemelerle ilgili tüm yasal ve vergi yükümlülüklerinden siz sorumlusunuz. Yükümlülükleriniz konusunda emin değilseniz bir vergi danışmanına başvurun.

​
Stripe hesabınızı etkinleştirin

Canlı API anahtarlarına erişmeden önce Stripe, işletmenizi doğrulamanızı ister. Bu, tamamen Stripe tarafında gerçekleşen standart bir katılım sürecidir.
1

Stripe Dashboard'u açın

dashboard.stripe.com adresine gidin ve sandbox’ı sahiplenmek için kullandığınız hesapla oturum açın.
2

Kurulum kılavuzunu tamamlayın

Stripe sizden hesap kurulumunuzu tamamlamanızı isteyecektir. Bu genellikle şunları içerir:
  • İşletme bilgileri (yasal ad, adres, işletme türü)
  • Kişisel kimlik doğrulaması
  • Ödemeleri almak için banka hesabı veya ödeme bilgileri
Tüm adımlar tamamlandı olarak işaretlenene kadar Stripe’ın kurulum kılavuzunu takip edin.
3

Doğrulamayı bekleyin

Stripe bilgilerinizi inceler ve hesabınızı etkinleştirir. Bu genellikle anındadır ancak ülkenize ve işletme türünüze bağlı olarak birkaç gün sürebilir.Doğrulandıktan sonra hesabınız canlı olur ve canlı API anahtarlarınız Dashboard’da kullanılabilir hale gelir.
Stripe’ın hesabınızı doğrulamasını beklerken projenizi test modunda oluşturmaya ve test etmeye devam edebilirsiniz.

​
Canlı API anahtarlarınızı girin

Stripe hesabınız doğrulandıktan sonra canlı anahtarlarınızı Macaly’ye kopyalayın.
1

Anahtarlarınızı Stripe Dashboard'undan kopyalayın

Stripe Dashboard’unda API anahtarlarınız, ana sayfanın sağ tarafındaki API keys kartında gösterilir. Ayrıca kenar çubuğunun altındaki Developers → API keys altında da bulabilirsiniz.İki anahtar göreceksiniz:
  • Publishable key, pk_live_ ile başlar.
  • Secret key, sk_live_ ile başlar.
Her iki anahtarı da kopyalayın.
Gizli anahtarınız Stripe hesabınıza tam erişim sağlar. Onu asla paylaşmayın veya sohbete yapıştırmayın.
2

Anahtarlarınızı Macaly'ye ekleyin

Ödemeler sekmesinde Stripe bağlantısı ekle’ye tıklayın. Her anahtarı ilgili alana yapıştırın ve API anahtarlarını kaydet’e tıklayın. Test anahtarları (pk_test_ ve sk_test_) değil, canlı anahtarlarınızı (pk_live_ ve sk_live_ ile başlayan) kullandığınızdan emin olun.
3

Canlı moda geçin

Canlı moda geç’e tıklayın. Macaly, projenizi canlı Stripe hesabınızı kullanacak şekilde yeniden yapılandırır. Durum yeşil renkte Ödemeler Canlı olarak güncellenir.
4

Projenizi yayınlayın

Değişiklikleri dağıtmak için projenizi yayınlayın. Canlı ödemeler yalnızca yayınlanan sitede işlenir, önizlemede değil.

​
Entegrasyonunuzu yönetme

Tüm ödeme ayarlarına Ödemeler sekmesinden erişilebilir:
  • Stripe’ı aç, işlemleri incelemenizi, iade işlemi yapmanızı ve ödemeleri takip etmenizi sağlayan Stripe Dashboard’unu açar.
  • Canlı moda geç / Test moduna geç, proje kodunuzu etkilemeden ortamlar arasında istediğiniz zaman geçiş yapmanızı sağlar.
  • Stripe bağlantısını yönet, ilk yapılandırmadan sonra canlı API anahtarlarınızı güncellemenizi sağlar.
  • Test ödemeleri, test modundayken referans için test kartı bilgilerini gösterir.

​
Sorun giderme

Sandbox, Macaly’nin sizin için oluşturduğu geçici bir test ortamıdır. Kendi test API anahtarlarıyla gelir ve gerçek parayla uğraşmadan ödemeleri simüle etmenizi sağlar. Stripe hesabınız değildir. Sandbox’ı sahiplendiğinizde onu gerçek Stripe hesabınıza bağlarsınız. Sahiplenene kadar sandbox anonimdir ve 60 gün sonra sona erer.
Herhangi bir gelecek son kullanma tarihi, herhangi bir 3 haneli CVC ve herhangi bir posta koduyla 4242 4242 4242 4242 test kartı numarasını kullandığınızdan emin olun. Sorun devam ederse hata ayrıntıları için sohbeti gözden geçirin veya agent’tan ödeme akışını teşhis etmesini isteyin.
Test modu, test anahtarlarıyla sandbox ortamını kullanır. Tüm ödemeler simüle edilir ve gerçek para söz konusu değildir. Canlı mod, canlı anahtarlarla doğrulanmış Stripe hesabınızı kullanır. Gerçek para tahsil edilir ve banka hesabınıza yatırılır. Ödemeler sekmesinde istediğiniz zaman modlar arasında geçiş yapabilirsiniz. Mod değiştirmek proje kodunuzu etkilemez, yalnızca hangi Stripe anahtarlarının aktif olduğunu değiştirir.
Sandbox’ı sahiplenmek ve Stripe hesabınızı doğrulamak iki ayrı adımdır. Sahiplenme, sandbox’ı hesabınıza bağlar, ancak canlı anahtarlar oluşturulmadan önce Stripe’ın işletme doğrulamasını (kimlik, işletme bilgileri, banka hesabı) tamamlamanız gerekir. Stripe Dashboard’u açın ve doğrulamayı bitirmek için kurulum kılavuzunu takip edin. Yalnızca test anahtarları (pk_test_ ve sk_test_ ile başlayan) görüyorsanız hesabınız henüz tam olarak doğrulanmamıştır.
Stripe hesabınızı doğrulamak Macaly’yi otomatik olarak canlı moda geçirmez. Ödemeler sekmesinde canlı API anahtarlarınızı manuel olarak girmeniz ve ardından Canlı moda geç’e tıklamanız gerekir. Macaly, siz açıkça geçiş yapana kadar sizi test modunda tutar.
Sırayla üç şeyi kontrol edin:
  1. Projenizi yayınladınız mı? Canlı ödemeler yalnızca yayınlanan sitede işlenir, önizlemede değil.
  2. Anahtarlarınız doğru mu? Publishable key’i (pk_live_ ile başlayan) ve Secret key’i (sk_live_ ile başlayan) doğru girdiğinizi doğrulayın. Yanlışlıkla test anahtarları yapıştırdıysanız Stripe bağlantısını yönet’e tıklayın ve güncelleyin.
  3. Stripe hesabınız tam olarak doğrulandı mı? Stripe Dashboard’u açın ve kurulum kılavuzunda bekleyen adım olup olmadığını kontrol edin. Stripe, canlı ödemeleri işlemeden önce ek belgeler isteyebilir.
Sahiplenilmemiş sandbox’lar 60 gün sonra sona erer. Ödemeler sekmesini açın ve yeni bir ortam sağlamak için Yeni sandbox kur’a tıklayın. Mevcut ödeme kodunuz değişmeden kalır. Stripe hesabınızı daha önce sahiplenip doğrulamışsanız, yeni bir sandbox sağladıktan sonra canlı anahtarlarınızı yeniden girmeniz gerekir.

​
Bilmekte fayda var

  • Stripe ücretleri geçerlidir. Macaly, ödemeler için ek ücret almaz. Her işlem için standart Stripe işlem ücretleri geçerlidir (bkz. stripe.com/pricing).
  • Sandbox süresi. Sahiplenilmemiş test ortamları 60 gün sonra sona erer. Bu gerçekleşirse Ödemeler sekmesini açın ve yeni bir tane sağlamak için Yeni sandbox kur’a tıklayın.
  • Webhook’lar otomatik olarak yönetilir. Macaly tüm webhook uç noktalarını yapılandırır ve sürdürür. Stripe Dashboard’unda manuel kurulum gerekmez.
  • Test ve canlı ortamlar izolasyonludur. Test işlemleri canlı Stripe hesabınızda görünmez ve gerçek bir ücretlendirme yapılmaz.