HandyCafe Docs
owner it-admin

Integrasi POS

Halaman tetapan Integrasi menyambungkan pelayan HandyCafe yang layak kepada terminal Ödeal D2D. Ketersediaannya disemak melalui HandyCafe Cloud. Menu dan halaman ini disembunyikan sepenuhnya apabila kafe tersebut tidak dibenarkan menggunakan Ödeal.

Sebelum Anda Bermula

Anda memerlukan langganan HandyCafe Cloud yang aktif, satu kunci pedagang Ödeal dan satu kunci rahsia Ödeal. Anda juga mesti mencipta terminal tersebut dalam ruangan Cihazlarım milik Ödeal. Nama tepat yang ditetapkan kepada terminal itu ialah nilai externalDeviceKey. Mulakan dengan persekitaran Stage. Beralih ke Production hanya selepas Ödeal meluluskan kelayakan Production dan persediaan panggilan baliknya.

Konfigurasikan Ödeal

  1. Buka Tetapan dan pilih Integrasi.
  2. Dalam Akaun Ödeal, masukkan kunci pedagang dan kunci rahsia yang diberikan oleh Ödeal. HandyCafe menghantar nilai ini terus ke HandyCafe Cloud. Nilai tersebut disulitkan dan tidak disimpan dalam pangkalan data tempatan atau dipaparkan semula.
  3. Pilih Ujian Sambungan. Apabila terdapat kunci baharu, HandyCafe menyimpannya dengan selamat sebelum menguji sambungan API Ödeal. Ujian ini hanya mengesahkan akaun Ödeal. Ia tidak membuktikan bahawa terminal telah digandingkan atau berada dalam talian.
  4. Tambah terminal. Masukkan nama peranti tempatan yang jelas. Untuk Nama peranti Ödeal (externalDeviceKey), masukkan nama peranti yang tepat seperti yang dicipta dalam Ödeal. Kemudian masukkan PaxID pilihan, persekitaran, masa menunggu pembayaran, bandar pelanggan, daerah pelanggan, kadar VAT sesi dan kadar VAT pesanan.
  5. Dayakan Integrasi POS Aktif dan pilih Simpan.
  6. Lengkapkan satu resit tunai Stage dan satu pembayaran kad Stage untuk mengesahkan gandingan terminal serta kedua-dua laluan penyelesaian.

Hanya satu terminal Ödeal yang aktif disokong bagi setiap pelayan dalam keluaran ini. Ini menghalang sesuatu pembayaran daripada dihalakan ke terminal yang tidak diingini sebelum pemilih terminal untuk juruwang tersedia.

HandyCafe menyimpan inventori terminal secara tempatan sebelum Cloud mengesahkan pasangan kelayakan yang baharu. Penolakan kelayakan oleh Ödeal tidak membuang nama terminal atau medan gandingannya. Terminal yang memerlukan kelayakan baharu disimpan sebagai tidak aktif sehingga kelayakan tersebut disahkan bagi persekitaran yang dipilihnya.

Halaman Integrasi membaca inventori terminal terus daripada pangkalan data SQLite tempatan dan memaparkannya tanpa menunggu Cloud. Hanya status kelayakan yang disulitkan dan kebenaran penyedia jauh yang memerlukan permintaan ke Cloud.

Jika Ödeal menolak konfigurasi tersebut, HandyCafe memaparkan penjelasan yang dikembalikan oleh Ödeal. Respons yang menyatakan profil organisasi tidak ditemui bermakna pasangan kunci pedagang dan kunci rahsia itu bukan milik mana-mana organisasi dalam persekitaran Stage atau Production yang dipilih.

Kelakuan Pembayaran

Apabila kaedah pembayaran yang aktif ialah tunai atau kad, penutupan bayaran sesi PC, penutupan bayaran sesi konsol dan penutupan pesanan berdiri sendiri akan menghantar bakul idempoten ke Ödeal. Tunai dihantar sebagai pilihan pembayaran CASH seperti yang didokumenkan oleh Ödeal. Terminal merekodkan pembayaran tunai itu dan mencetak slip fiskal atau resit e-Arkib tanpa membuka skrin kutipan kad. Kad dihantar sebagai CREDITCARD; HandyCafe menunggu keputusan panggilan balik sementara pelanggan menyelesaikan pembayaran pada terminal. Penutupan bayaran yang mengandungi tunai dan kad sekali gus akan menghantar kedua-dua pilihan pembayaran bersama jumlah masing-masing.

Pelanggan boleh memilih pilihan ansuran pada terminal apabila kad dan perjanjian pedagang menyokongnya. HandyCafe menyimpan bilangan ansuran yang dilaporkan bersama jualan tempatan. Jualan tempatan hanya dimuktamadkan selepas Ödeal mengesahkan transaksi tersebut. Jika penyimpanan tempatan gagal selepas pengesahan itu, HandyCafe meminta pembatalan pada hari yang sama. Pembatalan yang gagal akan menghasilkan ralat penyelarasan manual dan mesti disemak dalam laporan transaksi Ödeal. Jenis kaedah pembayaran selain tunai dan kad terus mengikut aliran penyelesaian HandyCafe yang sedia ada.

Ujian dan Operasi Terminal

Ujian Sambungan hanya mengesahkan kelayakan pedagang Ödeal dan akses API. Ia tidak mencetak resit, tidak mengenakan caj pada kad dan tidak membuktikan bahawa externalDeviceKey telah digandingkan dengan terminal.

Dokumentasi API D2D yang dibekalkan tidak mentakrifkan titik akhir Cetak Resit Ujian atau Caj Ujian yang berasingan. Ujian penerimaan menggunakan bakul biasa dalam persekitaran Stage: hantar satu bakul tunai dan sahkan slip yang dicetak, kemudian hantar satu bakul kad dan selesaikan transaksi bayaran sekali gus atau bayaran ansuran pada terminal. Gunakan hanya butiran kad ujian Stage yang diberikan oleh Ödeal.

Kes penerimaan Ödeal turut merangkumi tutup hari dan cetak semula resit terakhir, tetapi kedua-duanya ialah operasi terminal. D2D tidak mendokumenkan panggilan API jauh untuknya, jadi HandyCafe tidak menyediakan butang jauh bagi operasi tersebut.

Dayakan dan Lumpuhkan dari Jauh

Pentadbir HandyCafe mengawal Ödeal daripada Admin > Tetapan Admin > Penyedia POS dalam Papan Pemuka. Suis global ialah kawalan induk. Nilai lalai negara menggunakan kod ISO dua huruf seperti TR. Kawalan kafe boleh membuka atau menutup Ödeal secara eksplisit bagi satu lesen. Keputusan khusus kafe mengatasi nilai lalai negara. Menetapkan semula keputusan kafe menjadikan kafe itu mengikut negaranya sekali lagi.

Susunan keputusan ialah suis global, keputusan khusus kafe kemudian nilai lalai negara. Suis global yang dilumpuhkan akan menutup Ödeal bagi setiap kafe. Penutupan kafe secara eksplisit menyembunyikan halaman ini walaupun negaranya dibuka. Pembukaan kafe secara eksplisit membenarkan halaman ini walaupun negaranya tiada dalam senarai lalai. Mematikan akses akan menyekat penciptaan bakul baharu serta-merta. Transaksi tertunggak yang sedia ada masih boleh disemak atau dibatalkan supaya pembayaran yang sedang berjalan tidak terkandas.

Pelayan menyemak ketersediaan melalui HandyCafe Cloud dan menyimpan cache keputusan negara atau kafe yang terakhir berjaya disahkan. Katalog penyedia mengembalikan HTTP 200 dengan error.code berstruktur apabila kelayakannya tidak sah. Aplikasi desktop mengendalikan respons itu dengan menyegarkan kelayakan dan mencuba semula. Kegagalan pengesahan atau rangkaian yang sementara tidak akan mentafsir semula keputusan admin yang mendayakan sebagai keputusan yang melumpuhkan, jadi menu Integrasi kekal stabil. Respons yang berjaya kemudiannya akan mengemas kini cache dengan serta-merta, termasuk keputusan admin untuk melumpuhkan. Tanpa keputusan yang pernah disahkan sebelum ini, negara kafe yang tidak diketahui, langganan yang tidak aktif atau penyedia yang dilumpuhkan akan mengekalkan halaman ini tersembunyi. Operasi Ödeal yang baharu sentiasa dibenarkan semula oleh Cloud walaupun ketika keterlihatan daripada cache digunakan. Negara yang disimpan pada lesen digunakan apabila profil kafe yang disegerakkan tidak mempunyai negara.

Keselamatan dan Pemulihan

Kelayakan Ödeal disulitkan dalam HandyCafe Cloud dengan kunci peti besi bagi persekitaran pemasangan tersebut. Permintaan panggilan balik disahkan oleh kunci permintaan yang dikonfigurasikan atau oleh pengepala pedagang dan rahsia Ödeal. Kod rujukan bakul kekal stabil bagi setiap pesanan atau sesi. Mengulangi penutupan bayaran yang sama tidak akan menghasilkan caj kedua.

Pembatalan Ödeal hanya boleh dilakukan mengikut peraturan hari yang sama yang ditetapkan Ödeal, iaitu sebelum kelompok terminal ditutup. Bakul yang masih tertunggak boleh dibuang secara berasingan sebelum pembayaran selesai. Ödeal D2D tidak menyediakan operasi bayaran balik umum. Gunakan back office Ödeal dan laporan transaksi apabila tempoh pembatalan telah berlalu.

Ödeal D2D tidak mendokumenkan sebarang operasi laporan Z atau tutup hari dari jauh. Selesaikan tutup hari pada terminal itu sendiri. HandyCafe boleh membaca laporan transaksi untuk penyelarasan dan merekodkan panggilan balik payback daripada Ödeal.