Mga POS Integration

Ikinokonekta ng settings page na Integrations ang isang karapat-dapat na HandyCafe server sa isang Ödeal D2D terminal. Sinusuri ang availability sa pamamagitan ng HandyCafe Cloud. Ganap na nakatago ang menu at ang pahina kapag hindi pinapayagang gumamit ng Ödeal ang cafe.

Bago Ka Magsimula

Kailangan mo ng aktibong HandyCafe Cloud subscription, isang Ödeal merchant key at isang Ödeal secret key. Kailangan mo ring gawin ang terminal sa Cihazlarım area ng Ödeal. Ang eksaktong pangalang itinalaga sa terminal na iyon ang externalDeviceKey nito. Magsimula sa Stage environment. Lumipat lang sa Production pagkatapos aprubahan ng Ödeal ang production credentials at ang setup ng callback.

I-configure ang Ödeal

1. Buksan ang Settings at piliin ang Integrations.
2. Sa Ödeal Account, ilagay ang merchant key at secret key na ibinigay ng Ödeal. Direktang ipinapadala ng HandyCafe ang mga halagang ito sa HandyCafe Cloud. Naka-encrypt ang mga ito at hindi iniimbak sa lokal na database o muling ipinapakita.
3. Piliin ang Connection Test. Kapag may bagong key, ligtas munang iniimbak ng HandyCafe ang mga ito bago subukan ang koneksyon sa Ödeal API. Bineberipika lang ng test na ito ang Ödeal account. Hindi nito pinapatunayan na naka-pair o online ang terminal.
4. Idagdag ang terminal. Maglagay ng malinaw na lokal na pangalan ng device. Para sa Ödeal device name (externalDeviceKey), ilagay ang eksaktong pangalan ng device na ginawa sa Ödeal. Pagkatapos ay ilagay ang opsyonal na PaxID, ang environment, ang oras ng paghihintay sa bayad, ang lungsod ng customer, ang distrito ng customer, ang rate ng VAT sa session at ang rate ng VAT sa order.
5. I-enable ang POS Integration Active at piliin ang Save.
6. Kumpletuhin ang isang Stage cash receipt at isang Stage card payment para beripikahin ang pagpapares ng terminal at ang dalawang daanan ng settlement.

Isang aktibong Ödeal terminal lang ang suportado bawat server sa release na ito. Pinipigilan nito na maipadala ang isang bayad sa maling terminal bago maging available ang terminal selector para sa cashier.

Lokal na iniimbak ng HandyCafe ang terminal inventory bago beripikahin ng Cloud ang bagong pares ng credential. Ang pagtanggi ng Ödeal sa isang credential ay hindi nagtatapon sa pangalan ng terminal o sa mga field ng pagpapares. Ang terminal na nangangailangan ng bagong credential ay iniimbak bilang inactive hanggang maberipika ang mga credential na iyon para sa napiling environment nito.

Direktang binabasa ng Integrations page ang terminal inventory mula sa lokal na SQLite database at ipinapakita ito nang hindi naghihintay sa Cloud. Ang naka-encrypt na status ng credential at ang pahintulot ng remote provider lang ang nangangailangan ng kahilingan sa Cloud.

Kung tinanggihan ng Ödeal ang configuration, ipinapakita ng HandyCafe ang paliwanag na ibinalik ng Ödeal. Ang tugong organization profile not found ay nangangahulugang hindi kabilang ang pares ng merchant at secret sa isang organisasyon sa napiling Stage o Production environment.

Pag-uugali ng Pagbabayad

Kapag cash o card ang aktibong paraan ng pagbabayad, ang checkout ng PC session, ang checkout ng console session at ang pagsasara ng standalone na order ay nagpapadala ng idempotent na basket sa Ödeal. Ipinapadala ang cash bilang CASH payment option na nakadokumento ng Ödeal. Itinatala ng terminal ang cash payment at ipini-print ang fiscal slip o ang e-Archive na resibo nang hindi binubuksan ang screen ng koleksyon ng card. Ipinapadala ang card bilang CREDITCARD; naghihintay ang HandyCafe ng resulta ng callback habang kinukumpleto ng customer ang bayad sa terminal. Ang checkout na naglalaman ng cash at card ay nagpapadala ng dalawang payment option na may kani-kanilang halaga.

Maaaring pumili ang customer ng installment option sa terminal kapag sinusuportahan ito ng card at ng kasunduan sa merchant. Iniimbak ng HandyCafe ang iniulat na bilang ng installment kasama ang lokal na benta. Isinasapinal lang ang lokal na benta pagkatapos kumpirmahin ng Ödeal ang transaksyon. Kung mabigo ang lokal na commit pagkatapos ng kumpirmasyon, humihiling ang HandyCafe ng kanselasyon sa parehong araw. Ang nabigong kanselasyon ay bumubuo ng error sa manual na reconciliation at kailangang suriin ito sa transaction report ng Ödeal. Ang mga uri ng paraan ng pagbabayad maliban sa cash at card ay nagpapatuloy sa umiiral na daloy ng settlement ng HandyCafe.

Mga Test at Operasyon sa Terminal

Bineberipika lang ng Connection Test ang Ödeal merchant credentials at ang access sa API. Hindi ito nagpi-print ng resibo, hindi nagsisingil sa card at hindi pinapatunayan na naka-pair ang externalDeviceKey sa terminal.

Ang ibinigay na dokumentasyon ng D2D API ay hindi nagtatakda ng hiwalay na endpoint para sa Print Test Receipt o Test Charge. Gumagamit ang acceptance testing ng normal na basket sa Stage environment: magpadala ng cash basket at beripikahin ang naka-print na slip, pagkatapos ay magpadala ng card basket at kumpletuhin ang isang single-payment o installment na transaksyon sa terminal. Gamitin lang ang mga detalye ng Stage test card na ibinigay ng Ödeal.

Kasama sa mga acceptance case ng Ödeal ang day close at ang muling pag-print ng huling resibo, ngunit mga operasyon ito sa terminal. Hindi nagdodokumento ang D2D ng mga remote API call para sa mga ito, kaya hindi inilalantad ng HandyCafe ang mga ito bilang remote na button.

Remote na Pag-enable at Pag-disable

Kinokontrol ng mga administrator ng HandyCafe ang Ödeal mula sa Admin > Admin Settings > POS Providers sa Dashboard. Ang global switch ang pangunahing kontrol. Gumagamit ang mga default ng bansa ng dalawang letrang ISO code gaya ng TR. Maaaring tahasang buksan o isara ng mga kontrol sa cafe ang Ödeal para sa isang lisensya. Nangingibabaw sa default ng bansa ang desisyong tiyak sa cafe. Ang pag-reset sa desisyon ng cafe ay nagpapasunod muli sa cafe na iyon sa bansa nito.

Ang pagkakasunod-sunod ng desisyon ay global switch, desisyong tiyak sa cafe at pagkatapos ay ang default ng bansa. Ang naka-disable na global switch ay nagsasara ng Ödeal para sa bawat cafe. Ang tahasang pagsasara ng isang cafe ay nagtatago sa pahina kahit bukas ang bansa nito. Ang tahasang pagbubukas ng isang cafe ay nagpapahintulot sa pahina kahit wala ang bansa nito sa default na listahan. Ang pagsara ng access ay agad na humaharang sa paglikha ng bagong basket. Masusuri o makakansela pa rin ang mga umiiral na pending na transaksyon para hindi maiwang nakabitin ang isang bayad na kasalukuyang isinasagawa.

Sinusuri ng server ang availability sa pamamagitan ng HandyCafe Cloud at kina-cache nito ang huling matagumpay na naberipikang desisyon sa bansa o cafe. Nagbabalik ang provider catalog ng HTTP 200 na may structured na error.code kapag hindi valid ang credential nito. Tinutugunan ng desktop ang tugong iyon sa pamamagitan ng pag-refresh sa credential at muling pagsubok. Ang pansamantalang pagkabigo sa authentication o network ay hindi muling binibigyang-kahulugan ang naka-enable na desisyon ng admin bilang naka-disable, kaya nananatiling matatag ang menu na Integrations. Ang matagumpay na tugon sa susunod na pagkakataon ay agad na nag-a-update sa cache, kasama ang desisyon ng admin na mag-disable. Kapag walang dating naberipikang desisyon, nananatiling nakatago ang pahina kung hindi kilala ang bansa ng cafe, hindi aktibo ang subscription o naka-disable ang provider. Palaging inaawtorisa muli ng Cloud ang mga bagong operasyon ng Ödeal kahit ginagamit ang naka-cache na visibility. Ginagamit ang bansang nakaimbak sa lisensya kapag walang bansa ang naka-sync na profile ng cafe.

Seguridad at Pagbawi

Naka-encrypt sa HandyCafe Cloud ang mga credential ng Ödeal gamit ang deployment vault key. Pinapatotohanan ang mga callback request sa pamamagitan ng naka-configure na request key o ng mga Ödeal merchant at secret header. Hindi nagbabago ang mga basket reference code para sa bawat order o session. Ang pag-ulit sa parehong checkout ay hindi lumilikha ng pangalawang singil.

Available lang ang kanselasyon sa Ödeal sa ilalim ng mga panuntunan nito para sa parehong araw bago magsara ang batch ng terminal. Maaaring alisin nang hiwalay ang isang pending na basket bago makumpleto ang bayad. Hindi nagbibigay ang Ödeal D2D ng pangkalahatang operasyon para sa refund. Gamitin ang back office at ang transaction report ng Ödeal kapag lumipas na ang panahon para sa kanselasyon.

Hindi nagbibigay ang Ödeal D2D ng nakadokumentong remote na Z report o operasyon para sa pagsasara ng araw. Kumpletuhin ang pagsasara ng araw sa terminal. Nababasa ng HandyCafe ang mga transaction report para sa reconciliation at itinatala nito ang mga payback callback mula sa Ödeal.