Geliştiriciler
Entegrasyonu yapan ekip için: API dokümantasyonu, SDK'lar, webhook akışı, test ortamı ve hata kodları.
Entegrasyonun neresindesiniz?
Test ve canlı anahtarlar, dokümantasyon ve test ortamı erişimi hesap açılışında tanımlanır. Ödemeyi kim alacak?
Hesap işletme adına açılır. Başvuru ücretsizdir; ilk formda belge istenmez. Kapsam ve varsa ücretler teklifinizde yazılı olur.
Başvuruyu ödemeyi alacak işletme yapar; anahtarlar ve dokümantasyon işletmenin hesabına tanımlanır, entegrasyonu o hesapla kurarsınız. İşletmeye şu mesajı iletebilirsiniz:
Merhaba, sitede ya da uygulamada kartla ödeme alabilmek için sanal POS başvurusunun işletme adına yapılması gerekiyor. Başvuru ücretsiz, ilk adım kısa bir form; belgeler sonraki aşamada istenir: https://www.sanalpos.com/sanal-pos-basvuru?utm_source=gelistirici&utm_medium=mesaj&utm_campaign=gl#basvuru-formu — Hesap açılınca test ve canlı anahtarlar tanımlanıyor; entegrasyonu oradan tamamlayabilirim.
Sorularınız için: 0212 909 00 87
Sanal POS başvurusu için vergi mükellefi olmak gerekir; şahıs şirketleri ve serbest meslek erbabı da başvurabilir. Şirket kurmayı ya da mükellefiyeti düşünüyorsanız mali müşavirinize danışın. Bazı ödeme kuruluşları geliştiricilerin canlı sözleşme olmadan test hesabı açmasına izin verir; bunu kuruluşun geliştirici sayfasından kontrol edebilirsiniz. Akışı öğrenmek için: örnek kodlar · imza deneme alanı · test senaryoları.
Test ortamında en çok vakit kazandıran üç sayfa:
- Test senaryoları: kuruluşunuzun kart listesinde hangi etiketleri arayacağınız ve kodunuzda neyi doğrulayacağınız.
- Örnek istek: tutar ve para birimi biçimleri, örnek istek gövdesi.
- İmza deneme alanı: bildirim imzasını tarayıcıda hesaplayıp sunucunuzla karşılaştırın.
Canlı anahtarlar sunucu ortam değişkeninde, bildirim adresi HTTPS ve dışarıdan erişilebilir, ilk gerçek işlem düşük tutarla denenmiş olsun.
Kodu yazın; anlamını, kimin çözeceğini ve ne yapılacağını görün: POS hata kodları →
Dokümantasyon
API Dokümantasyonu
Sanal POS API dokümantasyonu: dokümantasyona erişim, API'nin genel yapısı, tutar ve para birimi biçimleri, örnek istek gövdesi. Erişim hesap açılışında iletilir.
Entegrasyon Kılavuzu
Sanal POS entegrasyon kılavuzu. Adım adım kurulum, örnek kodlar ve best practices. PHP, Node.js, Python desteği. Test ortamı ve canlıya geçiş adımları.
Örnek Kodlar
Sanal POS örnek kodlar. PHP, Node.js, Python için hazır kod örnekleri. Ödeme, sorgu, iade ve bildirim akışını gösteren örnekler.
Webhook ve Callback
Webhook ve Callback rehberi. Gerçek zamanlı ödeme bildirimleri, callback URL yapılandırması ve güvenlik imza doğrulama rehberi.
SDK'lar
PHP SDK
Sanal POS PHP SDK paketi ve dokümantasyonu. Composer ile kurulum, ödeme işlemleri, webhook ve callback kullanımı; örnek kodlar ve API referansı.
Node.js SDK
Sanal POS Node.js SDK paketi ve dokümantasyonu. NPM ile kurulum, ödeme işlemleri, webhook ve callback kullanımı; örnek kodlar ve API referansı.
Python SDK
Sanal POS Python SDK paketi ve dokümantasyonu. pip ile kurulum, ödeme işlemleri, webhook ve callback kullanımı; örnek kodlar ve API referansı.
Test ve Hata Ayıklama
Test Ortamı (Sandbox)
Sanal POS sandbox test ortamı ve test kartları. Test anahtarlarıyla akışı gerçek para hareketi olmadan deneyin; erişim hesap açılışında tanımlanır.
Test Kartları
Test kartlarıyla denemeniz gereken başarılı ve başarısız işlem senaryoları; kart numaraları kuruluşunuzun test listesinde yazar.
POS Hata Kodları
POS hata kodları ne demek? 05, 51, 63, 76, 96 ve 3D Secure hataları dahil yaygın kodların anlamı ve çözümü. Kod numarasıyla arayın.