FAQ

You can find answers to the questions we most frequently encounter on this page.

What is App2App integration?

It is a profile model in which both the Partner application and the Ödeal application are installed on a device supplied by Ödeal, a payment transaction starts in the partner application and is finalized in the Ödeal application, and the e-document is generated based on that payment transaction.

What is Device2Device integration?

It is a profile in which the Partner's device is registered to the Ödeal POS device. The basket is created on the Partner's device, sent to the Ödeal device, and the payment is completed on the Ödeal application side. It is a profile model in which the e-document is generated based on the payment transaction.

What are Secret and API Keys needed for?

When sending a request to an Ödeal service, it must be sent using these keys. This way, the merchant and device the request was sent for can be identified.

Where can Secret and API Keys be obtained when needed?

In the test environment, they can be requested from the integration support team or by emailing [email protected]. In the production environment, information is provided in the documentation at the link "docs.odeal.com.tr/entegrasyon/en/guide/servis-anahtari."

How are refund and cancellation transactions performed?

A refund transaction is not currently available. A cancellation, however — the cancellation of a transaction that has already taken place — can be performed both through the Ödeal application and the partner application. It can be done as long as the transaction has not yet been settled (finalized). In other words, if the end-of-day has not been taken from the device, a transaction can be cancelled. If the end-of-day has been taken, the transactions within the relevant batchId have already been settled, so they can no longer be cancelled. For cancellation via the API, see docs.odeal.com.tr/entegrasyon/tr/api/d2d/odeme-iptali-d2d for the D2D profile; for the A2A profile, you can email [email protected] and the necessary documentation will be shared with you.

How do I generate a device code (externalDeviceKey) for the DEVICE2DEVICE profile?

If your profile is D2D, you can log in to the Ödeal application on the POS device, go to the "My Devices" tab from the menu bar in the top left, and generate a device code there.

The My Devices section isn't showing?

If the My Devices section isn't showing, your profile type may have been configured incorrectly. You can request that your profile be set to D2D by emailing [email protected].

How is the invoice generated after a payment is completed?

Once a payment is successfully completed, your invoice is automatically generated by Ödeal — no additional action is required. Afterwards, the generated invoice can be checked via the invoice portal. If you prefer, you can also access your invoice by scanning the QR code on the slip printed from the POS device.

Can a single merchant use both the D2D and A2A profiles?

If a merchant has more than one POS device, different devices can use different profiles. We can enable this by updating the profile on a per-terminal basis. For the test environment, requests can be made to [email protected]; for the production environment, requests can be made through the Ödeal call center.

What should we do about the "No profile found for the specified organization" error?

When you encounter this error, your API Key information may be incorrect, or your profile may have been defined incorrectly. First, check your API key information; if the error persists, you can request support by emailing [email protected].

We updated our mobile app on the APP2APP profile — how do we roll it out to our customers?

The updated mobile app's APK, along with its version information, is shared by emailing [email protected]. The process is then carried on by Ödeal, and once the rollout begins, feedback is provided back to the partner.

How do I update an incorrect profile type?

For the test environment, you can email [email protected] with the physical serial number printed on the back of the device; for the production environment, you can contact the Ödeal call center to open an update request.

The Settings menu on the POS device is asking for a password?

The partner can request support by emailing [email protected].

I get a red91 error when testing a credit card transaction, what should I do?

You can request support by emailing [email protected]. Real cards are not valid in the test environment.

I get an "Your e-invoice/e-archive definitions are missing" error, what should I do?

If you are using the configuration method, you may get this error if you previously sent a request without including the "eInvoiceIntegrator": "ODEAL" field in the request body. The request should be sent again with this field added. If you are getting this error even though you are not using the configuration method, you can request support by emailing [email protected].

Where can I see the version information of the Ödeal application?

Inside the Ödeal application on the POS device, you can find the version information by tapping the "About Us" tab from the menu in the top left.

What should I do about the "We are currently unable to process your request" error?

When this error occurs, you can wait a while and try again; if the problem persists, you can get information by emailing [email protected].

Where can I find the logs for a transaction performed on the device?

If your test device is a Debug build, a log is generated for every operation performed in the Ödeal application via Chucker in the POS device's notification bar; error logs appear in yellow and red text. Tapping on these entries lets you view the request and response values. You can take screenshots of these logs and attach them in an email to [email protected] to request support.