Ödeal Fiziki POS: bağlama, adisyon tahsilatı ve kaldırma

Ödeal Fiziki POS entegrasyonu, adisyondaki hizmet ve ürünleri Ödeal POS cihazınıza gönderir. Ödeme cihazda alındığında adisyon Piyzi’de otomatik olarak tamamlanır ve tahsilat Ödeal POS ödeme yöntemiyle kaydedilir. Bağlama ve tahsilat yalnız web panelinden yapılır; mobil uygulamada Ödeal yoktur.

Ön koşullar

• Aboneliği aktif bir Piyzi hesabı.

• Ödeal penceresini açmak, başvurmak ve bağlamak için rolünüzde Entegrasyonları yapabilir yetkisi (işletme sahibi her zaman yapabilir). Adisyonu POS’a göndermek için ayrıca Adisyonları güncelleyebilir yetkisi gerekir.

• Zaten Ödeal işyeriyseniz: Ödeal’in verdiği Public Key ve Secret Key ile kurulu POS cihazınızın kodu. Cihaz kodu, cihazın “Cihazlarım” menüsünde tanımlıdır.

• Ödeal işyeriniz yoksa: başvuru formu için işletme, yetkili kişi ve adres bilgileriniz (aşağıda).

Bağlanma

Pi Store’da Ödeme Yöntemleri başlığı altındaki Ödeal Fiziki POS kartına tıklayın. Açılan pencerenin üstünde iki seçenek vardır: Yeni Ödeal başvurusu (açılışta seçili) ve Zaten Ödeal işyeriyim. Hangi yolu seçerseniz seçin entegrasyon, Ödeal’in verdiği Public Key, Secret Key ve POS cihaz kodu Piyzi’ye girildiğinde çalışmaya başlar; başvuru yolunda bu bilgileri onaydan sonra girersiniz.

Ödeal anahtarlarınızla bağlanma

1. 1

   Ödeal penceresini açın

   Sol menüden İşletmem → Pi Store sayfasını açın ve Ödeme Yöntemleri başlığı altındaki Ödeal Fiziki POS kartına tıklayın.

2. 2

   Zaten Ödeal işyeriyim’i seçin

   Pencerenin üstündeki Zaten Ödeal işyeriyim düğmesine basın.

3. 3

   Anahtarları girin

   Public Key (İşyeri Anahtarı) ve Secret Key (Gizli Anahtar) alanlarına Ödeal’in verdiği değerleri yapıştırın. Alanlar gizli yazılır; göz simgesiyle yazdığınızı kontrol edebilirsiniz.

4. 4

   Cihaz kodunu girin

   POS Cihaz Kodu alanına cihazın “Cihazlarım” menüsündeki kodu yazın (örnek biçim: PAX710159330).

5. 5

   Bağlanın

   Bağlan düğmesine basın. Üç alan da zorunludur; biri boşsa “Public Key, Secret Key ve cihaz kodu zorunludur.” uyarısı çıkar. Piyzi anahtarları ve cihaz kodunu Ödeal’de anında doğrular; geçerliyse sayfa yenilenir ve kartta Bağlı rozeti görünür.

• Bağlantı kurulduğunda İşletmem → Ayarlar → Ödeme Yöntemleri listesine sistem yönetimli “Ödeal POS” yöntemi eklenir; listede kilit simgesiyle görünür, düzenlenemez ve silinemez.

• “Ödeal POS” tahsilat pencerelerindeki ödeme yöntemi listesinde de görünür. Bu yöntemi elle seçmek cihazdan çekim yapmaz, yalnız tahsilat kaydı oluşturur.

• Ödeme sonucu bildirimleri (callback) için Piyzi’nin adresleri Ödeal’e otomatik kaydedilir.

• Yeni bir Ödeal başvurusu oluşturulmaz; mevcut işyeriniz olduğu gibi kullanılır.

Ödeal işyeriniz yoksa: başvuru

Yeni Ödeal başvurusu bir başvuru formudur, bağlanma adımı değildir. Bilgileriniz Ödeal’e iletilir; ekrandaki bilgiye göre Ödeal başvuruyu yaklaşık 3 iş gününde değerlendirir ve onaydan sonra POS cihazını kurar. Formu doldururken alanların tam adları şöyledir:

1. 1

   İşletme Bilgileri

   İşletme Tipi (Tüzel (Şirket) ya da Şahıs), Şirket Unvanı (Ticari ad), Marka Adı (Tabela), Vergi Numarası (VKN) (10–11 hane), Yetkili TC Kimlik No (11 hane, son hanesi çift), İşyeri Kategori Kodu (MCC) (yalnız rakamlardan oluşan 3–6 haneli kart işlem kategori kodunuz; bilmiyorsanız Ödeal’e sorun) ve IBAN (opsiyonel) (doldurursanız TR ile başlayan 26 karakter).

2. 2

   Yetkili Kişi

   Yetkili Adı, Yetkili Soyadı, Cep Telefonu (başında 0 olmadan, 5XXXXXXXXX), İşyeri Telefonu (başında 0 olmadan 10 hane) ve E-posta.

3. 3

   Adres

   İl, İlçe ve Açık Adres. Bu adres cihazın kurulum adresi olarak da Ödeal’e iletilir.

4. 4

   Cihaz ve Hizmet

   Cihaz Modeli (opsiyonel) (A920Pro ya da A910), Hizmet Tipi (EFT POS (Fiziki cihaz), Yazarkasa POS (507) ya da Cepte POS (SoftPOS)) ve isterseniz Taksitli ödeme alınabilsin.

5. 5

   Belgeler (opsiyonel)

   Kimlik belgesi, imza sirküleri, vergi levhası, sözleşmeler, İVD başvuru belgesi ve e-belge imzasını şimdi yükleyebilirsiniz (en fazla 10 MB; PNG, JPG, PDF, DOC). Yüklemezseniz Ödeal sizden ayrıca isteyebilir.

6. 6

   Başvurun

   Başvuru Yap düğmesine basın. İşletme, yetkili kişi ve adres alanlarının tamamı (IBAN hariç) zorunludur: eksik alan varsa “Lütfen zorunlu alanları doldurun.”, biçimi uymayan bir alan varsa o alana özel bir uyarı (örneğin “Geçerli bir TC Kimlik No girin (11 hane, son hane çift).”) çıkar. Başvuru oluşunca “Ödeal başvurunuz oluşturuldu.” mesajı görünür.

• Başvurudan sonra pencerede “Başvurunuz inceleniyor” görünür; Ödeal bir not düştüyse “Ödeal geri bildirimi” satırında okunur. Pencereyi her açtığınızda ve “Durumu Yenile”ye bastığınızda durum Ödeal’den yeniden sorgulanır.

• Ödeal bu süreçte sizinle iletişime geçip kimlik, imza sirküleri, vergi levhası ya da sözleşme gibi ek evrak isteyebilir.

• Onaylanmamış bir başvuruyu “Başvuruyu İptal Et” ile geri çekebilirsiniz; “Emin misiniz?” sorusunu “Evet, kaldır” ile onaylayınca başvuru Ödeal’de de iptal edilir.

• Başvuru reddedilirse “Başvurunuz reddedildi” ve varsa gerekçesi görünür; form yeniden açılır, bilgileri düzeltip tekrar başvurabilirsiniz.

• Form tarayıcıda geçse bile Ödeal bilgileri kabul etmezse “Ödeal başvurusu oluşturulamadı. Lütfen girdiğiniz bilgileri kontrol edip tekrar deneyin.” uyarısı çıkar.

Onaydan sonra bağlantıyı tamamlama

1. 1

   Pencereyi açın

   Başvurunuz onaylandığında Ödeal penceresinde “Başvurunuz onaylandı” ve Bağlantı için gerekenler listesi görünür: Ödeal başvuru onayı, POS cihaz kodu, Public Key ve Secret Key; her satırda “Tamamlandı” ya da “Eksik” yazar. Ödeal bir cihaz kurulum kodu ilettiyse burada “Cihaz kurulum kodu” olarak görünür.

2. 2

   Cihaz kodunu girin

   POS cihazınız kurulduktan sonra cihazın “Cihazlarım” menüsündeki kodu POS Cihaz Kodu alanına yazın.

3. 3

   Anahtarları girin

   Ödeal işyeri anahtarları bölümüne Ödeal’in onaydan sonra (genellikle e-postayla) ilettiği Public Key ve Secret Key değerlerini girin.

4. 4

   Kaydedin

   Kaydet ve Bağlantıyı Tamamla düğmesine basın. Cihaz kodu boşsa “Cihaz kodu zorunludur.”, anahtarlardan biri eksikse “Public Key ve Secret Key zorunludur.” uyarısı çıkar. Piyzi üçünü birden Ödeal’de doğrular; geçerliyse “Bilgiler kaydedildi, Ödeal POS bağlantısı tamamlandı.” mesajıyla sayfa yenilenir, kartta “Bağlı” görünür ve ödeme yöntemlerinize “Ödeal POS” eklenir. Bilgiler kaydedildiği hâlde bağlantı tamamlanmadıysa “Bilgiler kaydedildi, ancak bağlantı için eksik alan var.” uyarısı çıkar; listede “Eksik” yazan satırı tamamlayın.

• Anahtarlar kaydedildikten sonra bir daha gösterilmez; yerlerinde “Anahtarlar kayıtlı” yazar ve düğmenin adı “Cihaz Kodunu Kaydet” olur. Bağlantı tamamlanmadan önce Ödeal yeni anahtar ilettiyse “Değiştir” ile güncelleyebilirsiniz.

• Bağlantı tamamlanmadan kart “Bağlı Değil” görünür ve adisyonu POS’a göndermek “Önce Ödeal POS başvurusu oluşturmalısınız.” uyarısı verir.

Adisyonu POS’a gönderme

1. 1

   Adisyonu açın

   Sol menüden Adisyonlar sayfasını açıp tahsil edeceğiniz adisyona tıklayın.

2. 2

   POS’a gönderin

   Üstteki işlem düğmeleri arasından Ödeal POS'a Gönder düğmesine basın. Düğme tamamlanmamış her adisyonda görünür; tamamlanmış adisyonda görünmez.

3. 3

   Ödemeyi cihazdan alın

   Kalemler cihaza düşer ve “POS ödemesi bekleniyor” penceresi açılır. Ödemeyi cihazdan tamamlayın; ödeme türünü (nakit, kart, yemek kartı) cihazda seçersiniz ve fiş gerçek türü yansıtır.

4. 4

   Sonucu görün

   Sonuç geldiğinde bekleme penceresi kapanır, adisyon tazelenir ve “Ödeme alındı”, “Ödeme başarısız”, “Ödeme iptal edildi” ya da “Ödeme hâlâ bekleniyor” penceresi açılır.

• Gönderilen tutar adisyonun kalan borcudur. Kalan borç kalemler toplamına eşitse hizmet ve ürünler KDV oranlarıyla kalem kalem gider; bu toplamdan farklıysa (örneğin bir kısmı önceden tahsil edildiyse) tek bir “Kalan Tutar” satırı gönderilir.

• İptal edilmiş ve gelmedi işaretli randevuların hizmetleri ile paketten karşılanan hizmetler sepete girmez.

• Satır indirimleri ve genel indirim kalem tutarlarına yansıtılır.

• Adisyon müşterisinin düzenleme penceresindeki Fatura Bilgileri sekmesi doluysa (Kurumsal: Ünvan ve 10 haneli Vergi No (VKN); Bireysel: 11 haneli TC Kimlik No) bilgiler sepete eklenir; boşsa satış nihai tüketici olarak gider. E-belgeyi Ödeal oluşturur; belge Piyzi’de görüntülenmez.

• Aynı adisyonu tekrar gönderirseniz cihazdaki ödenmemiş eski sepet önce silinir ve cihazda yalnız yeni sepet kalır. Ödemesi cihazda alınmış ama sonucu henüz Piyzi’ye ulaşmamış bir adisyonu ise yeniden göndermeyin; cihazda ikinci bir sepet açılır.

• Adisyon tamamlanmışsa “Bu adisyon zaten tamamlanmış.”, tutarı sıfırsa “Bu adisyonda tahsil edilecek tutar bulunmuyor.” uyarısıyla gönderim engellenir.

• Dijital onam formları kullanıyorsanız ve müşterinin imzalaması zorunlu bir formu eksikse gönderim “Bu adisyonda imzalanması zorunlu form var. Tamamlamadan önce imzalatın.” uyarısıyla engellenir.

Ödeme sonucu

• Ödeme alındı: adisyon tamamlanır, tahsilat “Ödeal POS” yöntemiyle kaydedilir (İşletmem → Muhasebe & Finans → Ödemeler sayfasında da görünür), bağlı randevular tamamlandı olur (iptal ve gelmedi olanlar hariç), paket hakları düşülür ve tamamlanma otomasyonları çalışır.

• Ödeme başarısız: adisyon açık kalır; yeniden gönderebilirsiniz.

• Ödeme iptal edildi: işlem cihazda iptal edilmiştir, adisyon açık kalır.

• Alınmış ödeme sonradan cihazda iptal edilirse: Piyzi ödemeyi geri alır: tahsilat kaydı iptal edilir, adisyon ve bağlı randevular ödemeden önceki durumlarına döner, ödemeyle düşülen paket hakları yeniden ayrılmış (rezerve) duruma geçer.

• Ödeme hâlâ bekleniyor: beş dakika içinde sonuç ulaşmamıştır. Ödeme cihazda tamamlanırsa adisyon daha sonra kendiliğinden güncellenir; sayfayı yenileyerek kontrol edebilirsiniz.

• Bekleme penceresini kapatırsanız: pencerenin “Kapat” düğmesi takibi durdurur ama işlemi iptal etmez; cihazda tamamlanan ödeme adisyona yine işlenir.

Bağlantıyı kaldırma

1. 1

   Ödeal penceresini açın

   İşletmem → Pi Store sayfasında Ödeal Fiziki POS kartına tıklayın.

2. 2

   Bağlantıyı kesin

   Bağlantıyı Kes düğmesine basın ve “Emin misiniz?” sorusunu Evet, kaldır ile onaylayın. Başvurunuz incelemedeyse aynı işi Başvuruyu İptal Et düğmesi yapar.

• Kayıtlı anahtarlar ve cihaz kodu artık kullanılmaz; adisyonlar POS’a gönderilemez.

• Sistem yönetimli “Ödeal POS” ödeme yöntemi de kaldırılır. Bu yöntemle kaydedilmiş geçmiş tahsilatlar adisyonlarda kalır.

• Onaylanmamış bir başvurunuz varsa Ödeal tarafında da iptal edilir.

• Ödeal işyeriniz ve POS cihazınız Ödeal’de durmaya devam eder; onların kapatılması Ödeal ile görüşülür.

• Bağlıyken pencerede anahtar ya da cihaz kodu değiştirme alanı yoktur. Değiştirmek için bağlantıyı kesip “Zaten Ödeal işyeriyim” ile yeni bilgilerle yeniden bağlanın.

Sorun giderme

• “Önce Ödeal POS başvurusu oluşturmalısınız.”: bağlantı tamamlanmamış: hiç bağlanmadınız, başvurunuz incelemede ya da onaylı başvuruda cihaz kodu veya anahtarlar eksik. Ödeal penceresinden eksiği tamamlayın. Gönder düğmesi bağlantı olmasa da göründüğü için bu uyarı gönderim anında çıkar.

• “Cihaz kodu Ödeal'de bulunamadı veya geçersiz.”: bağlanırken cihaz kodu ya da anahtarlar doğrulanamadı; yanlış anahtar da bu uyarıyı verir. Cihaz kodunu POS cihazının “Cihazlarım” menüsünden birebir kopyalayın ve anahtarların bu cihazla aynı işyerine ait olduğundan emin olun.

• “Ödeal kimlik bilgileri geçersiz.”: eski bir bağlantıda anahtarlar kayıtlı değil. Ödeal penceresini açıp iki anahtarı cihaz koduyla birlikte girin.

• “Ödeal entegrasyonu sırasında bir hata oluştu.” (gönderirken): Ödeal sepeti kabul etmedi. Ödeal tarafında anahtarları yenilediyseniz bağlantıyı kesip yeni anahtarlarla bağlanın, sonra tekrar deneyin.

• Ödeme alındı ama adisyon kapanmadı: adisyonun tamamlanması, Ödeal’in ödeme bildirimini (callback) Piyzi’ye ulaştırmasına bağlıdır; önce sayfayı yenileyerek kontrol edin. Bildirimler gelmiyorsa Ödeal penceresindeki “Callback'leri yenile” düğmesiyle adresleri Ödeal’e yeniden gönderin. Ödemesi cihazda alınmış adisyonu POS’a yeniden göndermeyin; cihazda ikinci bir sepet açılır. Sorun sürerse Piyzi desteğine yazın.

• Ödeme yöntemi listeden silinemiyor: “Ödeal POS” yöntemi entegrasyon tarafından yönetilir ve kilitlidir; bağlantıyı kaldırdığınızda kendiliğinden gider.

• Tutar beklediğinizden düşük: paketten karşılanan hizmetler, iptal/gelmedi randevular ve indirimler tutarı düşürür; gönderilen değer kalan borçtur.