Ödeal physical POS: connecting, collecting payments and removing

The Ödeal physical POS integration sends the services and products on a sales card to your Ödeal POS device. When the payment is taken on the device, the sales card is completed automatically in Piyzi and the payment is recorded with the Ödeal POS payment method. Connecting and collecting are done in the web panel only; Ödeal is not available in the mobile app.

Prerequisites

• A Piyzi account with an active subscription.

• To open the Ödeal window, apply and connect, the Entegrasyonları yapabilir (manage integrations) permission in your role (the business owner can always do this). Sending a sales card to the POS also requires the Adisyonları güncelleyebilir (update sales cards) permission.

• If you are already an Ödeal merchant: the public key and secret key issued by Ödeal, and the code of your installed POS device. The device code is defined in the “My Devices” menu on the device.

• If you are not an Ödeal merchant yet: your business, authorized person and address details for the application form (below).

Connecting

In Pi Store, click the Ödeal Physical POS card under the Payment Methods heading. The window that opens has two options at the top: New Ödeal application (selected when it opens) and I'm already an Ödeal merchant. Whichever path you choose, the integration starts working once the public key, secret key and POS device code issued by Ödeal are entered in Piyzi; on the application path you enter them after approval.

Connecting with your Ödeal keys

1. 1

   Open the Ödeal window

   In the left menu, open My Business → Pi Store and click the Ödeal Physical POS card under the Payment Methods heading.

2. 2

   Choose I'm already an Ödeal merchant

   Click I'm already an Ödeal merchant at the top of the window.

3. 3

   Enter the keys

   Paste the values Ödeal gave you into Public Key (Merchant Key) and Secret Key. The fields are masked; use the eye icon to check what you typed.

4. 4

   Enter the device code

   Type the code from the device's “My Devices” menu into POS Device Code (example format: PAX710159330).

5. 5

   Connect

   Click Connect. All three fields are required; if one is empty, “The public key, secret key and device code are required.” appears. Piyzi verifies the keys and the device code with Ödeal straight away; if they are valid, the page reloads and the card shows the Connected badge.

• Once connected, a system-managed “Ödeal POS” method is added to the list under My Business → Settings → Payment Methods; it shows with a lock icon and cannot be edited or deleted.

• “Ödeal POS” also appears in the payment method list of the collection windows. Choosing it by hand does not charge the device; it only records a payment.

• Piyzi's addresses for payment result notifications (callbacks) are registered with Ödeal automatically.

• No new Ödeal application is created; your existing merchant account is used as it is.

If you are not an Ödeal merchant yet: applying

New Ödeal application is an application form, not a connection step. Your details are sent to Ödeal; according to the on-screen note, Ödeal reviews the application in about 3 business days and installs the POS device after approval. The fields are named as follows:

1. 1

   Business Information

   Business Type (Legal Entity (Company) or Sole Proprietor), Company Name (Trade name), Brand Name (Signage), Tax Number (VKN) (10–11 digits), Authorized Person's National ID No. (11 digits, last digit even), Merchant Category Code (MCC) (your card transaction category code, 3–6 digits only; ask Ödeal if you do not know it) and IBAN (optional) (if you fill it in, 26 characters starting with TR).

2. 2

   Authorized Person

   Authorized Person's First Name, Authorized Person's Last Name, Mobile Phone (without the leading 0, 5XXXXXXXXX), Business Phone (without the leading 0, 10 digits) and Email.

3. 3

   Address

   Province, District and Full Address. This address is also sent to Ödeal as the device installation address.

4. 4

   Device and Service

   Device Model (optional) (A920Pro or A910), Service Type (EFT POS (Physical device), Cash Register POS (507) or Phone POS (SoftPOS)) and, if you like, Allow instalment payments.

5. 5

   Documents (optional)

   You can upload an ID document, a signature circular, a tax certificate, contracts, the tax office application document and an e-document signature now (max 10 MB; PNG, JPG, PDF, DOC). If you do not, Ödeal may request them separately.

6. 6

   Apply

   Click Apply. All business, authorized person and address fields (except the IBAN) are required: if something is missing, “Please fill in the required fields.” appears, and a field in the wrong format shows its own warning (for example “Enter a valid national ID number (11 digits, last digit even).”). Once the application is created, “Your Ödeal application was created.” appears.

• After you apply, the window shows “Your application is under review”; if Ödeal left a note, you can read it in the “Feedback from Ödeal” line. The status is queried from Ödeal again every time you open the window and when you click “Refresh Status”.

• Ödeal may contact you during this period and ask for additional documents such as an ID, a signature circular, a tax certificate or a contract.

• You can withdraw an application that has not been approved with “Cancel Application”; once you confirm “Are you sure?” with “Yes, remove it”, the application is cancelled at Ödeal too.

• If the application is rejected, “Your application was rejected” appears with the reason when there is one; the form opens again so you can correct the details and apply again.

• Even if the form passes in the browser, Ödeal may refuse the details; then “The Ödeal application could not be created. Please check the details you entered and try again.” appears.

Completing the connection after approval

1. 1

   Open the window

   When your application is approved, the Ödeal window shows “Your application was approved” and the What the connection needs list: Ödeal application approval, POS device code, public key and secret key; each line says “Completed” or “Missing”. If Ödeal sent a device setup code, it appears here as “Device setup code”.

2. 2

   Enter the device code

   Once your POS device is installed, type the code from the device's “My Devices” menu into POS Device Code.

3. 3

   Enter the keys

   In the Ödeal merchant keys section, enter the public key and secret key Ödeal sent you after approval (usually by email).

4. 4

   Save

   Click Save and Complete the Connection. If the device code is empty, “The device code is required.” appears, and if a key is missing, “The public key and secret key are required.” appears. Piyzi verifies all three with Ödeal; if they are valid, the page reloads with “The details were saved and the Ödeal POS connection is complete.”, the card shows “Connected” and “Ödeal POS” is added to your payment methods. If the details were saved but the connection is not complete, “The details were saved, but the connection is still missing information.” appears; complete the line marked “Missing” in the list.

• Once saved, the keys are never shown again; “Keys are saved” appears in their place and the button becomes “Save Device Code”. If Ödeal sent new keys before the connection was completed, you can update them with “Change”.

• Until the connection is complete the card shows “Not Connected”, and sending a sales card to the POS returns “You must create an Ödeal POS application first.”

Sending a sales card to the POS

1. 1

   Open the sales card

   In the left menu, open Sales Cards and click the sales card you want to collect.

2. 2

   Send it to the POS

   Among the action buttons at the top, click Send to Ödeal POS. The button appears on every sales card that is not completed and is hidden on completed ones.

3. 3

   Take the payment on the device

   The lines are pushed to the device and an “Awaiting POS payment” dialog opens. Complete the payment on the device; you choose the payment type (cash, card, meal card) there and the receipt reflects the actual type.

4. 4

   See the result

   When the result arrives, the waiting dialog closes, the sales card is refreshed and a “Payment received”, “Payment failed”, “Payment cancelled” or “Payment still pending” dialog opens.

• The amount sent is the remaining balance of the sales card. If the remaining balance equals the total of the lines, services and products are sent line by line with their VAT rates; if it differs from that total (for example because part of it was collected earlier), a single “Kalan Tutar” (remaining amount) line is sent.

• Services on cancelled and no-show appointments, and services covered by a package, are not included in the basket.

• Line discounts and the general discount are reflected in the line amounts.

• If the Billing Information tab in the customer's edit window is filled in (Corporate: Title and a 10-digit Tax No. (VKN); Individual: an 11-digit National ID No.), those details are added to the basket; if it is empty, the sale goes through as a final consumer. Ödeal issues the e-document; it is not shown in Piyzi.

• If you send the same sales card again, the previous unpaid basket on the device is deleted first and only the new basket remains on the device. Do not resend a sales card whose payment was already taken on the device but whose result has not reached Piyzi yet; a second basket would open on the device.

• Sending is blocked with “This sales card has already been completed.” if the sales card is completed, and with “There is nothing to collect on this sales card.” if its amount is zero.

• If you use digital consent forms and the customer has a form that must be signed but is not, sending is blocked with “This sales card has a form that must be signed. Get it signed before completing.”

The payment result

• Payment received: the sales card is completed, the payment is recorded with the “Ödeal POS” method (it also appears under My Business → Accounting & Finance → Payments), linked appointments are marked completed (except cancelled and no-show ones), package sessions are deducted and the completion automations run.

• Payment failed: the sales card stays open; you can send it again.

• Payment cancelled: the transaction was cancelled on the device and the sales card stays open.

• If a payment that was taken is later cancelled on the device: Piyzi reverses it: the payment record is cancelled, the sales card and the linked appointments return to their previous states, and the package sessions deducted by the payment go back to reserved.

• Payment still pending: no result arrived within five minutes. If the payment is completed on the device, the sales card is updated on its own later; you can refresh the page to check.

• If you close the waiting dialog: its “Close” button stops tracking but does not cancel the transaction; a payment completed on the device is still applied to the sales card.

Removing the connection

1. 1

   Open the Ödeal window

   On the My Business → Pi Store page, click the Ödeal Physical POS card.

2. 2

   Disconnect

   Click Disconnect and confirm “Are you sure?” with Yes, remove it. If your application is under review, the Cancel Application button does the same.

• The stored keys and the device code are no longer used; sales cards cannot be sent to the POS.

• The system-managed “Ödeal POS” payment method is removed as well. Past payments recorded with it stay on their sales cards.

• If you have an application that has not been approved, it is cancelled at Ödeal too.

• Your Ödeal merchant account and POS device remain with Ödeal; closing those is arranged with Ödeal.

• While connected, the window has no field for changing the keys or the device code. To change them, disconnect and reconnect with the new details through “I'm already an Ödeal merchant”.

Troubleshooting

• “You must create an Ödeal POS application first.”: the connection is not complete: you never connected, your application is under review, or the device code or keys are missing on an approved application. Complete what is missing in the Ödeal window. Because the send button shows even without a connection, this message appears at the moment you send.

• “The device code wasn't found at Ödeal or is invalid.”: the device code or the keys could not be verified while connecting; wrong keys also produce this message. Copy the device code exactly as it appears in the device's “My Devices” menu, and make sure the keys belong to the same merchant account as that device.

• “The Ödeal credentials are invalid.”: an older connection has no keys stored. Open the Ödeal window and enter both keys together with the device code.

• “An error occurred during the Ödeal integration.” (while sending): Ödeal did not accept the basket. If you regenerated the keys at Ödeal, disconnect and reconnect with the new keys, then try again.

• The payment was taken but the sales card did not close: completing the sales card depends on Ödeal delivering the payment notification (callback) to Piyzi; refresh the page first. If notifications are not arriving, use the “Refresh callbacks” button in the Ödeal window to re-send the addresses to Ödeal. Do not send a sales card whose payment was already taken on the device again; a second basket would open on the device. If the problem continues, contact Piyzi support.

• The payment method cannot be deleted from the list: the “Ödeal POS” method is managed by the integration and locked; it disappears on its own when you remove the connection.

• The amount is lower than you expected: services covered by a package, cancelled/no-show appointments and discounts reduce the amount; the value sent is the remaining balance.