Ö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ızca web panelinden yapılır.

Ön koşullar

• Aboneliği aktif bir Piyzi hesabı.

• Pi Store düzenleme yetkisi ya da işletme sahibi olmanız. Adisyonu POS’a göndermek için ayrıca adisyon düzenleme yetkisi gerekir.

• Ödeal tarafında tanımlı bir üye işyeri ve kurulmuş bir POS cihazı.

• Public Key, Secret Key ve POS cihaz kodu — üçü de Ödeal tarafından verilir.

Bağlanma

Pi Store’daki Ödeal kartı iki yol sunar: Zaten Ödeal işyeriyim ve Yeni Ödeal başvurusu. Entegrasyonu çalışır duruma getiren yol, anahtarlarınızla bağlandığınız birincisidir.

Ödeal anahtarlarınızla bağlanma

1. Sol menüden İşletmem → Pi Store bölümünü açın.

2. Ödeme Yöntemleri başlığı altındaki “Ödeal Fiziki POS” kartına tıklayın.

3. “Zaten Ödeal işyeriyim” seçeneğine geçin.

4. Ödeal’den aldığınız Public Key ve Secret Key değerlerini girin.

5. POS cihazının “Cihazlarım” menüsünde tanımlı cihaz kodunu girin.

6. “Bağlan” düğmesine basın. Piyzi anahtarları ve cihaz kodunu Ödeal’de anında doğrular; bilgiler geçerliyse entegrasyon aktifleşir.

• Bağlantı kurulduğunda ödeme yöntemleri listenize sistem yönetimli “Ödeal POS” yöntemi eklenir; bu yöntem düzenlenemez ve silinemez.

• Ö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

Kartın Yeni Ödeal başvurusu sekmesi bir başvuru formudur, bir bağlanma adımı değildir. Formu gönderdiğinizde işletme, yetkili ve adres bilgileriniz Ödeal’e iletilir; isterseniz kimlik, imza sirküleri, vergi levhası gibi belgeleri de yükleyebilirsiniz.

• Başvurudan sonra durum “Başvurunuz inceleniyor” olarak görünür; “Durumu Yenile” düğmesi Ödeal’den güncel durumu çeker.

• Ödeal bu süreçte sizinle iletişime geçip ek evrak isteyebilir.

• Onaylanmamış bir başvuruyu “Başvuruyu İptal Et” ile kaldırabilirsiniz.

• Onaydan sonra işyerinizin açılması ve POS cihazının kurulması Ödeal tarafından yürütülür.

Adisyonu POS’a gönderme

1. Adisyon detayını açın.

2. Üstteki aksiyonlar arasından “Ödeal POS’a Gönder” düğmesine basın. Bu düğme, tamamlanmamış her adisyonda görünür.

3. Adisyondaki kalemler cihaza düşer ve “POS ödemesi bekleniyor” penceresi açılır.

4. Ödemeyi cihazdan tamamlayın. Ödeme türünü (nakit, kart, yemek kartı) cihazda seçersiniz; fiş gerçek türü yansıtır.

5. Sonuç geldiğinde bekleme penceresi kapanır ve adisyon tazelenir.

• Gönderilen tutar adisyonun kalan borcudur. Kalan borç kalemler toplamına eşitse hizmet ve ürünler KDV oranlarıyla kalem kalem gider; kısmi tahsilatta 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üşterisinde fatura bilgisi varsa (kurumsal unvan/VKN veya bireysel TC kimlik no) sepete eklenir; yoksa satış nihai tüketici olarak gider. E-belge Ödeal tarafında oluşturulur, Piyzi saklamaz.

• Aynı adisyonu tekrar gönderirseniz cihazdaki ödenmemiş eski sepet önce silinir; böylece iki kez tahsilat riski oluşmaz.

• Tahsil edilecek tutar kalmadıysa veya adisyon zaten tamamlandıysa gönderim engellenir.

Ödeme sonucu

• Ödeme alındı: adisyon tamamlanır, tahsilat “Ödeal POS” yöntemiyle kaydedilir, 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.

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

• Bekleme penceresini kapatırsanız: takip durur ama işlem iptal olmaz; cihazda tamamlanan ödeme adisyona yine işlenir.

Bağlantıyı kaldırma

1. İşletmem → Pi Store bölümünü açın.

2. Ödeal Fiziki POS kartına tıklayın.

3. “Bağlantıyı Kes” düğmesine basıp onaylayın.

• Kayıtlı anahtarlar ve cihaz kodu Piyzi’den silinir; adisyonlar artık 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.

• Dilediğiniz zaman aynı adımlarla yeniden bağlanabilirsiniz.

Sorun giderme

• “Ödeal kimlik bilgileri geçersiz”: işyerine ait Public Key ve Secret Key kayıtlı değil. Bağlantıyı “Zaten Ödeal işyeriyim” yolundan anahtarlarla kurun.

• “Cihaz kodu Ödeal’de bulunamadı”: 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.

• “Önce Ödeal POS başvurusu oluşturmalısınız”: entegrasyon bağlı değil ya da cihaz kodu boş. Gönder düğmesi bağlantı olmasa da göründüğü için bu hata gönderim anında çıkar.

• Ödeme alındı ama adisyon kapanmadı: adisyonun tamamlanması, Ödeal’in ödeme bildirimini (callback) Piyzi’ye ulaştırmasına bağlıdır. Bildirim adresleri kayıtlı değilse veya erişilemiyorsa bekleme penceresi zaman aşımına uğrar ve adisyon açık kalır. Kartın üstündeki “Callback’leri yenile” düğmesiyle adresleri Ödeal’e yeniden gönderip ödemeyi tekrar deneyin.

• Ödeme yöntemi listeden silinemiyor: “Ödeal POS” yöntemi entegrasyon tarafından yönetilir; 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.