Özellik

API ve SDK Entegrasyonu

Ödeme akışını kendi yazılımınıza bağlamanın iki yolu vardır: HTTP üzerinden doğrudan REST çağrıları ya da hazır SDK paketleri. İkisinde de istek ve yanıt yapısı aynıdır; SDK yalnızca imzalama, yeniden deneme ve yanıt ayrıştırma gibi tekrar eden işleri üstlenir. Aşağıdaki bölümler API üzerinden hangi işlemlerin yapıldığını, hangi geliştirici kaynaklarının kullanıldığını ve erişimin nasıl yönetildiğini anlatır.

REST çağrısı ya da hazır SDK
Test ve canlı anahtarlar ayrı
Ödeme sonucu sunucu bildirimiyle kesinleşir

Ücretsiz Başvuru → Size uygun yolu bulun ↓

API anahtarları ve dokümantasyon erişimi, hesabınız açıldıktan sonra tanımlanır.

Uç noktalar, alan adları ve SDK kapsamı çalışılacak ödeme kuruluşunun çözümüne göre belirlenir; kesin bilgi hesabınız açıldığında iletilen dokümantasyonda yer alır.

Size uygun yol

Sanal POS API’si mi, hazır eklenti mi, ödeme linki mi?

Ödeme adımını nereye bağlayacağınızı seçin; API’ye gerçekten ihtiyacınız olup olmadığını ve sıradaki adımı görün.

Kartla ödeme adımını nereye bağlayacaksınız?

Üç adım

Entegrasyon nasıl ilerler?

Anahtardan canlı işleme giden sıra.

Anahtarlarınızı alın.

Hesabınız açıldığında test ve canlı anahtarlarınız ayrı ayrı tanımlanır. Anahtarları kod deposuna yazmayın; sunucu ortam değişkeninde tutun.

Entegrasyonu kurun.

SDK paketini projenize ekleyin ya da REST uç noktalarına doğrudan istek gönderin. Ödeme başlatma, 3D Secure yönlendirmesi ve sonuç bildirimi aynı akışın parçalarıdır.

Test edip canlıya alın.

Akışı test anahtarlarıyla uçtan uca çalıştırın; doğruladıktan sonra canlı anahtarlara geçin. Uç nokta adresleri ve anahtarlar dışındaki kod genelde aynı kalır.

Entegrasyon süresi kendi yazılımınızın yapısına ve seçilen çözüme göre değişir.

Ücretsiz Başvuru →

Anahtarların tanımlanması için önce başvurunuzu tamamlamanız gerekir.

Entegrasyon yolları

Ödeme akışını kendi yazılımınıza bağlayın.

İster doğrudan REST çağrılarıyla, ister hazır SDK paketleriyle ilerleyin; istek ve yanıt yapısı aynı kalır. Aşağıdaki üç başlık entegrasyonun ana parçalarını özetler.

REST API

HTTP üzerinden JSON istek ve yanıt
Anahtarla kimlik doğrulama
Hata kodları ve durum alanları

Uç nokta adresleri ve alan yapısı seçilen çözüme göre değişir.

Hazır SDK paketleri

PHP, Node.js ve Python için kütüphaneler
İmzalama ve yanıt ayrıştırma hazır
Örnek kod ve hata yönetimi

Paket adı ve sürüm desteği, hesabınız açıldığında iletilen dokümantasyonda belirtilir.

Test ve canlıya geçiş

Ayrı test anahtarları
Başarılı ve başarısız senaryolar
Aynı kodla canlı anahtara geçiş

Test ortamında gerçek para hareketi olmaz; kapsam kuruma göre değişebilir.

API anahtarları ve dokümantasyon erişimi, hesabınız açıldıktan sonra tanımlanır.

Ücretsiz Başvuru →Test isteklerinde ve günlük kayıtlarında gerçek kart ya da müşteri verisi tutmayın. Ayrıntı için: KVKK Aydınlatma Metni.

Kimler için

API entegrasyonu hangi işletmelerde işe yarar?

Ödemeyi kendi yazılımınızın içinden yönetmek istediğiniz durumlarda.

E-ticaret siteleri

Sepet ve sipariş akışı

Ödeme adımını kendi sepet sayfanıza gömmek ve sipariş durumunu otomatik güncellemek için. Ayrıntı: e-ticaret sanal POS.

SaaS ve yazılım ürünleri

Abonelik ve yenileme

Üyelik planlarını, yenilemeleri ve iptalleri kendi panelinizden yönetmek için. Ayrıntı: SaaS ve yazılım ödemeleri.

Mobil uygulamalar

iOS ve Android

Uygulama içi ödeme akışını sunucu tarafında kurup mobil istemciden yönetmek için. Ayrıntı: mobil uygulama ödemeleri.

Emin değilseniz yukarıdaki yol seçiciyi kullanın; satış yönteminizi ön görüşmede konuşuruz.Başvuru nasıl ilerler?

İlgili sayfalar

Bununla birlikte incelenenler

Sandbox Ortamı

Gerçek para hareketi olmadan ödeme senaryolarını deneyin.

API Dokümantasyonu

İstek ve yanıt alanları, hata kodları ve çağrı sırası.

Test Ortamı (Sandbox)

Test anahtarları, test kartları ve canlıya geçiş adımları.

Sık sorulan sorular

API ve SDK entegrasyonu hakkında.

API entegrasyonu ne kadar sürer?

Süre kendi yazılımınızın yapısına, ödeme akışınızın karmaşıklığına ve seçilen ödeme kuruluşunun çözümüne göre değişir. Hazır SDK kullanan ekipler genellikle daha az kod yazar. Adım adım sıra için entegrasyon kılavuzu sayfasına bakın.

Hangi programlama dilleri destekleniyor?

Hazır kütüphaneler için PHP, Node.js ve Python SDK sayfalarına bakabilirsiniz. SDK kullanmak zorunlu değildir: REST yapısı sayesinde HTTP isteği gönderebilen bir dilden doğrudan çağrı yapılabilir. Kullanılabilir paketler seçilen çözüme göre değişir.

Sandbox ortamı ücretsiz mi?

Test ortamı erişimi ve anahtarları, hesabınız açıldıktan sonra tanımlanır. Kapsamı ve varsa ücreti teklifinizde yazılır; ayrıntı için fiyatlandırma ve test ortamı (sandbox) sayfalarına bakın.

Webhook bildirimleri nasıl çalışır?

İşlem durumu değiştiğinde, tanımladığınız adrese sunucudan HTTP isteği gönderilir; siz de bu bildirimi doğrulayıp kendi kaydınıza işlersiniz. Olay tipleri, alan yapısı ve imza doğrulama yöntemi seçilen çözüme göre değişir. Ayrıntı için webhook ve callback sayfasına bakın.

API rate limit nedir?

Belirli bir sürede gönderebileceğiniz istek sayısına konan üst sınırdır; altyapının kötüye kullanımını önlemek için uygulanır. Sınır aşıldığında genellikle 429 durum kodu döner ve yeniden deneme süresi yanıt başlığında bildirilir. Uygulanan değerler ve istisnalar hesabınız açıldığında iletilen dokümantasyonda belirtilir.

Entegrasyona başlayın

Önce başvurunuzu tamamlayalım.

API anahtarları ve dokümantasyon erişimi hesap açılışıyla tanımlanır. Ön değerlendirme için başvuru formunu doldurun.

Ücretsiz Başvuru →

Başvuru ücretsizdir. Teklifi inceleyip karar verin.

Başvuru nasıl ilerler? →

Sorularınız için:0212 909 00 87ya da WhatsApp’tan yazın

Ayrıntılar

API Özellikleri

Ödeme altyapısı, panelden elle yapılan işlemlerin çoğunu program arayüzü üzerinden de sunar. Aşağıdaki başlıklar yaygın kullanılan çağrı tipleridir; kapsam, alan adları ve hangilerinin hesabınıza tanımlı olduğu seçilen ödeme kuruluşunun çözümüne göre değişir.

Ödeme alma. Tek çekimli ve taksitli satış başlatma; 3D Secure doğrulamalı ya da doğrulamasız akış seçenekleri. Hangi seçeneklerin açık olacağı işletmenizin risk değerlendirmesine bağlıdır.
İade ve iptal. Tamamlanmış bir işlemin tamamını ya da bir bölümünü program arayüzünden iade etme, gün içinde iptal etme. Kesin kurallar ve süre sınırları sözleşmenizde yazar.
Kart saklama. Kart numarası yerine tokenization ile üretilen bir anahtarın saklanması; müşterinin sonraki alışverişinde kart bilgisini yeniden girmeden ödeme adımına geçmesi. Ayrıntı için tek tıkla ödeme ve tokenization sayfasına bakabilirsiniz.
Tekrarlayan ödeme. Abonelik planlarının oluşturulması, yenileme denemeleri ve iptal işlemleri. Başarısız yenilemede izlenecek yol kendi yazılımınızda tanımlanır.
Webhook bildirimleri. İşlem sonucu değiştiğinde sunucunuza gönderilen bildirimler. Ödeme sonucunu tarayıcıdan dönen yanıtla değil, bu bildirimle kesinleştirin; alan yapısı ve imza doğrulaması için webhook ve callback sayfasını kullanın.
Raporlama çağrıları. İşlem geçmişinin, hakediş ve iade kayıtlarının program arayüzünden çekilmesi. Dışa aktarım biçimleri ve sorgulanabilir alanlar kuruma göre değişir.
BIN sorgulama. Kart numarasının ilk hanelerinden banka, kart tipi ve uygulanabilir taksit seçeneklerinin sorgulanması. Dönen bilgi, kartı veren kuruluşun tanımına bağlıdır.
Ödeme linki oluşturma. Sepet ya da fatura için bağlantı üretip müşteriye e-posta veya kısa mesajla göndermek. Panelden yapılan işin program arayüzünden karşılığıdır; ayrıntı için link ile ödeme sayfasına bakın.
Kripto varlık: yok. Türkiye’de kripto varlıklar ödemelerde kullanılamaz (TCMB, Ödemelerde Kripto Varlıkların Kullanılmamasına Dair Yönetmelik, Nisan 2021); bu nedenle API ve SDK kapsamında kripto cüzdan ödemesi ya da kripto alım-satım entegrasyonu bulunmaz. Kapsam, yukarıda sayılan kartlı ödeme işlemleridir; kabul edilmeyen faaliyetler için yasaklı ürün ve hizmet listesine bakın.

Bu özelliklerin kapsamı ve varsa ücreti teklifinizde yazılır; ayrıntı için fiyatlandırma sayfasına bakın.

SDK ve Geliştirici Araçları

Hazır kütüphaneler, imza üretme ve yanıt ayrıştırma gibi tekrar eden işleri üstlendiği için entegrasyonda yazılan kod miktarını azaltır. Hangi paketlerin hesabınıza tanımlı olduğu ve paket adları, hesabınız açıldığında iletilen dokümantasyonda belirtilir.

PHP kütüphanesi. Bağımlılık yöneticisiyle projeye eklenir; ödeme başlatma, iade ve webhook doğrulama örnekleri için PHP SDK sayfasına bakın.
Node.js kütüphanesi. Sunucu tarafı JavaScript projeleri için; kurulum ve çağrı örnekleri Node.js SDK sayfasında.
Python kütüphanesi. Python tabanlı arka uçlar için; kurulum ve örnekler Python SDK sayfasında.
Dokümantasyon. Uç noktaların açıklaması, istek ve yanıt alanları, hata kodları ve çağrı sırası için API dokümantasyonu sayfasını kullanın.
Test ortamı. Kodunuzu canlıya almadan denemek için ayrı anahtarlarla çalışan ortam. Başarılı ve başarısız senaryoların nasıl çalıştırılacağı test ortamı (sandbox) sayfasında anlatılır.
Webhook rehberi. Bildirim adresinin tanımlanması, olay tipleri ve imza doğrulaması için webhook ve callback sayfasına bakın.

SDK kullanmak zorunlu değildir. Aynı işlemler doğrudan REST çağrılarıyla da yapılabilir; bu durumda imzalama ve hata yönetimini kendi tarafınızda kurarsınız.

API Güvenliği ve Erişim Yönetimi

Ödeme hizmetini ve güvenlik kontrollerini ilgili ödeme kuruluşu sunar. Aşağıdakiler entegrasyonda karşınıza çıkan genel uygulamalardır; yöntemler ve ayarlar seçilen çözüme göre değişir.

Şifreli iletişim. Çağrılar şifreli bağlantı üzerinden yapılır; desteklenen sürümler ve gereksinimler dokümantasyonda belirtilir.
Anahtar yönetimi. Test ve canlı anahtarlar ayrıdır. Anahtarları kod deposunda değil sunucu ortam değişkeninde tutun; sızdığından şüphelenirseniz yenileyin.
İstek doğrulama. Çağrılar anahtarla kimliklendirilir, bildirimler imza doğrulamasıyla kontrol edilir. Bu adım atlanırsa sahte bildirimler ayırt edilemez.
Hız sınırlama. Belirli bir sürede gönderilebilecek istek sayısına üst sınır konur. Sınır aşıldığında dönen kodu yakalayıp yeniden deneme mantığı kurmanız beklenir.
Kart verisi. Kart numarasını kendi sisteminizde saklamak yerine token kullanmak, taşıdığınız sorumluluğu azaltır. Kişisel veriler KVKK kapsamında işlenir; ayrıntı aydınlatma metninde yer alır.

Dönen hata kodlarının karşılığı için POS hata kodları sayfasını, adım adım kurulum sırası için entegrasyon kılavuzu sayfasını kullanabilirsiniz.