Başlamadan Önce: Hesap ve Anahtarlar
Entegrasyona başlamak için önce başvurunuzun tamamlanması ve hesabınızın açılması gerekir. Hesap açılışıyla birlikte test ve canlı anahtarlarınız ile dokümantasyon erişiminiz tanımlanır.
Anahtarları uygulama kodunuza gömmeyin; sunucu tarafında ortam değişkeni ya da yapılandırma dosyası gibi güvenli bir yerde tutun. Test anahtarları ile canlı anahtarlar ayrı ayrı verilir; ikisini aynı ortamda kullanmayın. Ödeme isteklerini yalnızca kendi sunucunuzdan gönderin; anahtarların tarayıcıya veya mobil uygulama paketine düşmesi, üçüncü kişilerin sizin adınıza işlem denemesine yol açabilir.
Bu aşamada karar vermeniz gereken ikinci konu, ödeme akışının nerede tamamlanacağıdır: müşteriyi ödeme sayfasına yönlendirecek misiniz, yoksa ödeme formunu kendi sitenizde mi göstereceksiniz? 3D Secure doğrulamasının nasıl ele alınacağı ve hangi akışların kullanılabildiği, çalışılacak ödeme kuruluşunun çözümüne göre değişir ve dokümantasyonunuzda belirtilir.
Entegrasyon Yolları
Aynı ödeme akışına dört farklı yoldan bağlanabilirsiniz.
Hazır platform eklentisi. Sitenizi yaygın bir e-ticaret paketiyle kurduysanız, çoğu durumda modülü yükleyip panelden anahtarlarınızı girmeniz yeterli olur. Desteklenen platformların ve sürümlerin listesi, seçilen çözümün dokümantasyonunda yer alır.
SDK ile. PHP, Node.js veya Python tarafında hazır bir kütüphane üzerinden çalışmak isterseniz istek imzalama ve yanıt çözümleme işlerini SDK üstlenir. SDK paketinin adı ve kurulum komutu, hesabınız açıldığında iletilen dokümantasyonda belirtilir. Dile göre örnekler için örnek kodlar ile PHP, Node.js ve Python sayfalarına bakabilirsiniz.
Doğrudan API ile. İstekler REST ve JSON tabanlıdır; HTTP isteği gönderebilen her dilde entegrasyon yapılabilir. Uç noktalar, zorunlu alanlar ve imzalama yöntemi için API dokümantasyonu sayfasını kullanın.
Link ile Ödeme. Siteniz ya da geliştirici kaynağınız yoksa, ödeme bağlantısı oluşturup müşterinizle paylaşarak tahsilat yapabilirsiniz. Bu yolda teknik kurulum gerekmez.
Test ve Doğrulama Adımları
Kod tarafındaki ilk çalışmayı her zaman test ortamında yapın. İzlenecek sıra şudur:
- Test anahtarlarıyla bir ödeme isteği oluşturun ve yanıtın beklediğiniz yapıda geldiğini doğrulayın.
- Başarılı ödeme senaryosunu test kartları ile uçtan uca çalıştırın; 3D Secure doğrulama adımını da akışa dahil edin.
- Başarısız senaryoları ayrıca deneyin: yetersiz bakiye, hatalı CVV, süresi dolmuş kart. Dönen kodların karşılığı için POS hata kodları sayfasına bakın.
- Webhook bildiriminin sunucunuza ulaştığını, imza doğrulamasının çalıştığını ve aynı bildirimin ikinci kez gelmesi durumunda siparişin tekrar işlenmediğini (idempotency) kontrol edin. Ayrıntı için webhook ve callback sayfasına bakın. İmzanızı örnek gövdeyle denemek için: imza deneme alanı.
- İade ve iptal akışlarını, kullanacaksanız, test ortamında deneyin.
Test ortamının kapsamı ve erişimi için test ortamı (sandbox) sayfasını inceleyin. Test ortamındaki işlemler gerçek para hareketine dönüşmez.
Canlıya Geçiş Kontrol Listesi
Test ortamında akış doğrulandıktan sonra canlıya geçebilirsiniz. Geçmeden önce şunları gözden geçirin:
- Test anahtarları canlı anahtarlarla değiştirildi ve test anahtarları koddan çıkarıldı.
- Ödeme isteklerinin gittiği adres canlı ortama güncellendi.
- Webhook adresiniz canlı ortam için tanımlandı ve HTTPS üzerinden erişilebilir durumda.
- Ödeme sonucu kendi veritabanınıza yazılıyor; başarısız ve beklemede kalan işlemler için de bir durum tutuluyor.
- Hata durumlarında müşteriye gösterilecek mesajlar hazırlandı; ham hata kodları doğrudan ekrana basılmıyor.
- İstek ve yanıt kayıtları tutuluyor, ancak kart numarası ve CVV gibi veriler kaydedilmiyor.
Canlıya alındıktan sonra ilk gerçek işlemi düşük tutarla deneyip hem panelde hem kendi sisteminizde göründüğünü doğrulamanız yerinde olur. Entegrasyonun sunduğu yeteneklerin genel çerçevesi için API ve SDK entegrasyonu sayfasına bakabilirsiniz.
