Başlarken

iyzico ödeme API’si, internet üzerinden ödeme kabul eden tüm üye işyerlerine hitap edecek bir şekilde, oturum bilgisi tutmayan (stateless) Restful servis odaklı bir mimaride geliştirilmiştir. iyzico'nun sunduğu sunucu taraflı programlama diline uygun istemciler(client) ile çok kolay entegre olunabilir. Başlamak için aşağıdaki adımları izleyebilirsiniz.

Sandbox(test) hesabı oluşturmak

iyzico servislerini test edebilmek için bu adresten kaydınızı gerçekleştirebilirsiniz. Email aktivasyonu gerekmeden giriş yapıp "Ayarlar" menüsünden servisleri test edebileceğiniz API ve Güvenlik anahtar değerlerine ulaşabilirsiniz.

Sandbox(test) kontrol panelinden alınan anahtarlar https://sandbox-api.iyzipay.com sorgu adresi(baseUrl) ile çalışmaktadır.

Sandbox(test) ortamında kullanılan değerler ve sorgu adresi(baseUrl) canlı ortamdaki değerler ve sorgu adresinden tamamen farklıdır.

İstemci(client) seçimi

iyzico entegrasyon için, sunucu taraflı programlama diline uygun 6 farklı istemci(client) sunar. Bu istemcilerden programlama yapmak istediğiniz dile uygun olanı seçip sandbox(test) bilgileri ile kullanmaya başlayabilirsiniz.

Projenizde kullandığınız istemciyi github hesabınız ile takip etmeyi unutmayınız. Böylece gelecek olan güncelleme ve yeniliklerden haberdar olabilirsiniz.

PHP .NET JAVA NODE RUBY PYTHON

Entegrasyon metoduna karar vermek

Ödeme Formu: Eğer işletmenizin amacı hızlı ve kolay bir şekilde ödeme almaya başlamak ise iyzico ödeme formunu tercih edilebilirsiniz. Ön yüz kontrolleri, BIN sorgulama, Taksit Sorgulama, 3D Secure ile ödeme, BKM Express ve Kart saklama entegrasyonları için ek sorgu yapmaya gerek kalmadan tek bir entegrasyon ile işlemler tamamlanır. Ödeme bazında 3D Secure ayarı ve taksit komisyon yönetimi iyzico kontrol panelinden kolayca düzenlenebilir. Üye iş yeri tasarımına göre pop-up veya responsive olarak yüklenebilir. iframe ve ortak ödeme sayfası olarak kullanım şekilleri mevcuttur.

API: Üye işyeri kendi ödeme formunu kullanır. Bu entegrasyonda iyzico servisleri üye işyeri ödeme formunun arkasında çalışır. İstenilen servisler iş modelinin ihtiyacına göre entegre edilebilir.

Entegrasyon sürecinde dikkat edilecek noktalar
  • Canlı ortamda iyzico API'ına gönderilen parametrelere müşteriden alınan bilgiler set edilmelidir. Müşteriniden alınmayan "dummy" değerler sorgu parametrelerine set edilmemelidir.
  • Ödeme işlemi sonucunda iyzico tarafından dönen cevaptaki değerler (price, paidPrice, basketId, conversationId) ile sizin sisteminize kaydattiğiniz değerleri karşılaştırmayı unutmayınız. Bir yanlışlık var ise, örneğin iyzico cevabındaki (response) fiyat parametreleri sizin sisteminizde kayıtlı olandan düşük ise, siparişin kargolanma sürecini durdurup işlem ayrıntılarını bir sorun olmasına karşın kontrol ediniz. Bu tür durumlarda iyzico entegrasyon ekibi ile iletişime geçerek yardım alabilirsiniz.
Canlı ortama geçiş
  • Geliştirmeler tamamlandıktan sonra ödeme adımlarınızı, test kartlarınız ile tüm durumlar için test edin.
  • iyzico servislerinden dönen ve olabilecek tüm hataları karşılayacak şekilde kodunuzu düzenleyin.
  • Sonuç sayfanızın iyzico'dan gelen yanıtı yorumlayabiliyor olmasına dikkat edin.
  • Hassas olmayan dataları ve yanıtları loglamaya dikkat edin.
  • Entegrasyonunuzun son kullanıcılar için Kişisel Verilerin Koruması Kanunu ile uyumlu olmasına dikkat edin.
  • iyzico entegrasyon ekibinin onayı için entegrasyon@iyzico.com mail adresi ile iletişime geçin.