HandyCafe Docs
owner it-admin

POS Integrations

There is no separate Integrations page in Settings. The Ödeal D2D terminal is set up on the Ödeal tab of Settings > Payment Methods, next to the other payment providers. The tab appears only for cafes whose HandyCafe Cloud provider catalog lists Ödeal.

For the setup itself (Ödeal account keys, Connection test, adding the terminal and unreconciled settlements), see Payment Providers. This page covers how payments flow through the terminal and how access is controlled.

Payment Behavior

When the payment method is cash or card, PC session checkout, console session checkout and standalone order closure send the basket to Ödeal. Each basket has a stable reference. Repeating the same checkout does not create a second charge.

  • Cash is sent as Ödeal's CASH payment option. The terminal records the payment and prints the fiscal slip or e-Archive receipt without a card collection screen.
  • Card is sent as CREDITCARD. HandyCafe waits for the result while the customer pays on the terminal.
  • Cash and card together sends both payment options with their amounts.

The customer can choose installments on the terminal when the card and the merchant agreement support it. HandyCafe stores the installment count with the sale.

The local sale is committed only after Ödeal confirms the transaction. If the local commit fails after confirmation, HandyCafe requests a same-day cancellation. If that cancellation also fails, the payment is listed under Unreconciled Ödeal settlements on the Ödeal tab and must be checked in the Ödeal transaction report.

Active card and cash payment methods are linked to the Ödeal routes when the terminal is saved. A card or cash method without an Ödeal route cannot bypass the terminal. Checkout stops with a warning and the operator selects a routed method on the Methods tab of Settings > Payment Methods. Other payment method types use the normal HandyCafe checkout.

Testing

Connection test only verifies the Ödeal merchant keys and API access. It does not print a receipt, charge a card or prove that the terminal is paired.

Ödeal D2D has no separate test receipt or test charge call. Test with normal baskets in the Stage environment: complete a cash sale and check the printed slip, then complete a card sale on the terminal. Use only the Stage test card details Ödeal provides.

Day close and last-receipt reprint are terminal operations. D2D has no remote call for them, which is why HandyCafe has no buttons for them. Complete the day close on the terminal.

Remote Enable and Disable

HandyCafe administrators control Ödeal from the HandyCafe Dashboard, under Admin > Admin Settings > POS Providers. The decision order is:

  1. Global switch. When it is off, Ödeal is closed for every cafe.
  2. Cafe decision. A cafe can be explicitly opened or closed for one license.
  3. Country default. Cafes without their own decision follow their country (two-letter ISO codes such as TR).

Closing access hides the Ödeal tab and blocks new baskets immediately. Pending transactions can still be checked or cancelled. A payment in progress is not stranded.

The server remembers the last decision it verified with HandyCafe Cloud. A temporary network or sign-in problem does not hide a tab that was allowed. Every new Ödeal operation is still authorized by Cloud.

Security and Recovery

The Ödeal keys are sent to HandyCafe Cloud, stored encrypted there and never shown again on the server.

Ödeal cancellation is possible only under Ödeal's same-day rules, before the terminal batch closes. A pending basket can be removed before the payment completes. Ödeal D2D has no general refund operation. Once the cancellation window has passed, use the Ödeal back office and transaction report.

Related Pages