Paynkolay Sanal POS: üye işyeri hesabınızı bağlama
Paynkolay üye işyeri hesabınızı Piyzi'ye bağlayın. Bu aşamada yalnız bağlantı kurulur; kartla online tahsilat özellikleri eklendiğinde bu bağlantıyı kullanacak. Gereken dört bilgi, bağlama, test etme, bilgileri güncelleme ve kaldırma adımları burada.
Son güncelleme: 20 Ekim 2026
Paynkolay entegrasyonu, işletmenizin Paynkolay üye işyeri (sanal POS) hesabını Piyzi'ye bağlar.
Bu aşamada yalnız bağlantı kurulur: bağladığınız hesapla henüz ödeme alınmaz ve müşterilerinize ödeme bağlantısı gönderilmez. Piyzi'ye kartla online tahsilat özellikleri eklendiğinde bu bağlantıyı kullanacak.
Bağlantıyı yalnız web panelinden kurarsınız; mobil uygulamada bu ekran yoktur.
Ön koşullar
Aboneliği aktif bir Piyzi hesabı.
İşletme sahibi olmak. Sanal POS hesabını yalnız işletme sahibi bağlayabilir, test edebilir, güncelleyebilir ve kaldırabilir. Ödemelerin hangi hesaba gideceğini belirleyen bir ayar olduğu için rolünde Entegrasyonları yapabilir yetkisi olan personel de bunları yapamaz. Entegrasyonları görebilir yetkisi olan personel pencereyi açıp bağlantının durumunu görebilir.
Paynkolay ile sözleşmesi yapılmış ve API yetkisi tanımlı bir üye işyeri hesabı. Hesap Piyzi'ye ait değildir; sözleşme, komisyon ve hakediş Paynkolay ile aranızdadır.
Paynkolay üye işyeri panelinizdeki dört bilgi (aşağıda).
Gereken bilgiler
sx (satış anahtarı): ödeme almak için kullanılır.
sx List (listeleme anahtarı): işlemleri listelemek ve raporlamak için kullanılır.
sx İptal (iptal ve iade anahtarı): iptal ve iade için kullanılır.
Merchant Secret Key (gizli anahtar): istekleri imzalamak için kullanılır; Paynkolay'a hiçbir zaman açık gönderilmez.
Bu dört bilgi Paynkolay üye işyeri panelinizde yer alır. Görünmüyorsa üye işyerinizde API yetkisi tanımlı değildir ya da ana kullanıcıyla giriş yapmamışsınızdır; Paynkolay satış temsilcinizle görüşün.
Hesabı bağlama
- 1Paynkolay penceresini açın
Sol menüden İşletmem → Pi Store sayfasını açın ve Ödeme Yöntemleri başlığı altındaki Paynkolay Sanal POS kartına tıklayın.
- 2Bilgileri girin
Dört alanı Paynkolay panelinizden kopyalayıp yapıştırın; dördü de zorunludur. Alanlar şifre gibi gizli görünür; yazdığınızı görmek için alanın sağındaki göz simgesine basın.
- 3Doğrula ve bağla'ya basın
Piyzi bilgileri kaydetmeden önce Paynkolay'a para hareketi oluşturmayan üç deneme isteği gönderir: Üye işyeri ve gizli anahtar, Listeleme anahtarı (sx List) ve İptal ve iade anahtarı (sx İptal). Üçü de geçerse bilgiler şifrelenerek kaydedilir, “Sanal POS bağlandı.” bildirimi çıkar ve kartta Bağlı rozeti görünür.
- 4Sonucu kontrol edin
Pencerede Bağlı ve Canlı ortam rozetleri, Kayıtlı bilgiler bölümü ve her kontrolün sonucunu gösteren Son kontrol bölümü görünür.
Bir kontrol bile geçmezse hiçbir bilgi kaydedilmez. Alanların üstünde hangi kontrolün geçmediği ve sebebi yazar, hatalı alan kırmızıyla işaretlenir; alanı düzeltip yeniden deneyin. Bir alanı boş bırakırsanız “Bütün alanları doldurun.” uyarısı çıkar.
Bilgileriniz nasıl saklanır?
Bilgiler kaydedilmeden önce Paynkolay'da doğrulanır; doğrulanmayan bilgi kaydedilmez.
Kaydedilen bilgiler şifrelenir ve ekranda bir daha gösterilmez. Kayıtlı bilgiler bölümünde yalnız anahtarların ilk ve son dört karakteri görünür; gizli anahtarın hiçbir parçası gösterilmez.
Bilgileri güncellerken dördünü de yeniden girersiniz; Piyzi kayıtlı bilgileri forma geri getirmez.
Bağlama, güncelleme, test ve kaldırma işlemleri kimin yaptığıyla birlikte Aktivite Logları'na yazılır; kayıtlarda anahtarların kendisi yer almaz.
Piyzi destek ekibi destek oturumunda sanal POS bilgilerini göremez, değiştiremez ve bağlantıyı kaldıramaz.
Bağlantıyı test etme
Bağlı hesabın hâlâ çalıştığını görmek için pencerenin altındaki Bağlantıyı test et düğmesine basın. Piyzi kayıtlı bilgilerle aynı üç deneme isteğini yeniden gönderir ve sonucu Son kontrol bölümüne yazar. Test geçerse “Bağlantı çalışıyor.”, geçmezse “Bağlantı testi geçmedi. Ayrıntılar pencerede.” bildirimi çıkar. Paynkolay panelinizde anahtarları yenilediyseniz test geçmez; bilgileri güncelleyin.
Bilgileri güncelleme
- 1Güncelleme formunu açın
Pencerenin altındaki ⋮ (Diğer işlemler) düğmesine basın ve Bilgileri güncelle'yi seçin.
- 2Bilgileri yeniden girin
Dört bilgiyi girip Doğrula ve kaydet'e basın. Yeni bilgiler doğrulanmadan kayıtlı bilgiler değişmez; Vazgeç ile kayıtlı bağlantıya geri dönersiniz.
Bağlantıyı kaldırma
- 1Kaldır'ı seçin
Pencerenin altındaki ⋮ düğmesinden Bağlantıyı kaldır'ı seçin.
- 2Onaylayın
“Bağlantı kaldırılsın mı?” sorusunu Bağlantıyı kaldır ile onaylayın.
Kayıtlı bilgiler Piyzi'den silinir; yeniden bağlamak için dördünü tekrar girmeniz gerekir.
Paynkolay hesabınıza dokunulmaz.
Kart Bağlı Değil olarak görünür.
Sorun giderme
“Gizli anahtar hatalı ya da bu üye işyerine ait değil.” Merchant Secret Key yanlış kopyalanmıştır ya da başka bir üye işyerine aittir. Bu kontrol geçmezse diğer iki kontrol “Denenmedi” görünür.
“Bu anahtara ait bir üye işyeri bulunamadı.” sx alanını kontrol edin.
“Bu anahtar bu işlem için yetkili değil; başka bir alandan kopyalanmış olabilir.” sx List ya da sx İptal alanına başka bir anahtar yapıştırılmıştır; işaretli alanı Paynkolay panelindeki doğru alandan yeniden kopyalayın.
“Bu anahtar satış anahtarıyla aynı üye işyerine ait değil ya da eksik kopyalanmış.” sx List ya da sx İptal başka bir üye işyerine aittir ya da eksik kopyalanmıştır; işaretli alanı Paynkolay panelinden baştan sona yeniden kopyalayın.
“Paynkolay şu an cevap vermiyor.” birkaç dakika sonra tekrar deneyin.
“Paynkolay beklenmeyen bir cevap verdi.” bilgileri kontrol edip tekrar deneyin; sorun sürerse Piyzi destek ekibine bildirin.
“Çok fazla deneme yapıldı. 15 dakika sonra tekrar deneyin.” güvenlik için bir işletme 15 dakikada en fazla 10 bağlama ya da test denemesi yapabilir.
Satış anahtarıyla ilgili uyarı: sx alanındaki anahtarın satış anahtarı olup olmadığı bağlanırken denenemez, çünkü deneme gerçek bir ödeme başlatırdı. Listeleme ve iptal anahtarlarınız satış anahtarıyla aynı yapıda değilse pencerede uyarı çıkar; üç anahtarı Paynkolay panelindeki doğru alanlardan kopyaladığınızı kontrol edin.
“Ortam değişti”: bilgiler farklı bir Paynkolay ortamında doğrulanmıştır. Bağlantıyı test edin; geçmezse bilgileri yeniden girin.
“Kayıtlı bilgiler okunamıyor”: Bilgileri yeniden gir düğmesiyle bilgileri tekrar girin; sorun sürerse Piyzi destek ekibine bildirin.
“Sanal POS şu an kullanılamıyor”: Piyzi tarafında bir ayar eksiktir; Piyzi destek ekibine bildirin.
Pencerede bağlama düğmesi yok: sanal POS'u yalnız işletme sahibi bağlayabilir; destek oturumunda da bağlanamaz.
Paynkolay anahtarlarınızı yalnız bu pencereye girin; e-posta, telefon ya da mesajla kimseyle paylaşmayın. Bir anahtarın başkasının eline geçtiğinden şüphelenirseniz Paynkolay'dan yenisini alın ve Piyzi'de bilgileri güncelleyin.