Troubleshooting - list of common pitfalls
Before contacting support, please run through the list of common pitfalls. This will save both you and us a lot of time. Here we go with the list.
Polling the server instead of using the callback
Many developers fail to implement the callback mechanism. Instead, they either rely on faulty strategies:
|Calling GetPaymentState only when the customer is redirected to the shop||This approach only works if the customer actually returns to the shop. If the user closes the browser after payment, but before returning to the shop, the merchant will not get notified about the successful payment. As a result, some developers choose to poll the server periodically. We strongly recommend using the callback.|
|Polling the server with GetPaymentState calls||This approach floods the Barion servers with unnecessary API calls, slowing it down. It is also more complex to code and to test. We strongly recommend using the callback.|
Always rely on the callback. The Barion server retries the callback 5 times, so the chances of losing a payment is very little.
Mixing up sandbox and live accounts
It is very easy to mix up Live and Sandbox environments. Since the two systems are totally separated, you can have an account with the same e-mail address in both systems. Double check, if you can not log on.
Forgot to update POSKey to live
It is very easy to mix up Live and Sandbox environments. A very common mistake is to not update the POSKey to the Live server when going live. Same goes to URL-s.
Shop not approved
Log on to Barion Web App and check if your shop is approved and open. Edit your shop and send it for approval (note that you must fill in all data to be able to do this). After sending the shop for approval, the Sandbox server approves the shop automatically, but the Live environment requires human approval. You will be notified about the process in e-mail.
Paying in your own shop
If you try to pay as the owner of the shop that started the payment (meaning the payer and payee e-mail addresses are the same), you will get an error message. You cannot pay in your own shop.
Bank card payment with extreme low amounts
Bank card payments do not work with very small amounts such as 1 HUF or 0.02 EUR. Please use the following amounts for card transactions, even when testing!
- CZK: 1.00 CZK or more
- EUR: 0.10 EUR or more
- HUF: 10 HUF or more
- USD: 0.10 USD or more
Authentication error upon request
If you have managed to avoid all problems mentioned above, yet you still receive an API response showing 'Authentication error', check your request JSON for errors. Broken multibyte strings or unescaped special characters can render the JSON unparseable, which prevents the Barion API from identifying your POSKey, resulting in an authentication error.
Firewall rejects GUID
Some firewalls produce a false positive when long GUID-s travel in https requests.
Wrong or missing API version
If you omit the version from the URL, the system assumes V1. In case of a V2 API, this will lead to an error. The correct way to call V2 API-s is
https://api.test.barion.com/v2/Payment/Start on the sandbox.
Using deprecated or obosolete encryption methods
All communication with the Barion system must be done using TLS v1.1 or above - former encryption standards (SSLv3, TLS1.0 etc.) are not allowed!