Troubleshooting

DEPRECATED

This guide is for the deprecated Flex.API. Please don't use it for new implementations.

See Integration Options, and feel welcome to ask our friendly help desk.

When you see no regular response:

Error Situation

Explanation

Our system receives an HTTP error code.

This is very unlikely. Please check your URL. Do you use the correct server address?

Our system expects HTML or JSON, but receives something different.

Please check (1) the request headers you send, and (2) the request method.

The server will respond with an HTML page, if you use GET. Please refer to the section for capture, or that for adding deliveries, and you will understand why.

If you use POST, then the Accept header determines the response format. Please check the header whether it is sent properly.

Our system receives JSON, but the status is not ok.

Please check the error codes.

Our customer cannot complete the Sofort payment, or the 3-D Secure check during credit card payment.

Despite its name, you should not open the iframe_url within an Iframe ( <iframe> ):

  • It is forbidden to conduct a Sofort payment within an Iframe. (s. link to Sofort Integration Center)

  • 3-D Secure checks can leave the Iframe and switch to full-screen. In this case, the success (url_success) or failure URL (url_failure) of the shop is not opened inside the Iframe, but in the uppermost browser window (DOM window.top).

  • Some popular browsers have very strict same-origin restrictions for third party content, so that Cookie technology will not work inside Iframes. Most external authorisation flows cannot be completed.

When the response indicates a certain error:

Error Code

Explanation

0001

Invalid API key.

(1) The API key is invalid or missing.

Is it that one you have received from us? Is anything missing or too much? Maybe you cut off the first or last characters, or there are additional spaces or quotes.

Former keys differed between test and production. If this is the case, please check if it is the right key. If your think your former key for the test environment became invalid in over time, please get in touch with us.

(2) A malformed request body is processed in some cases, but sometimes it is indicated by error code 0001.

0002

Invalid hash.

(1) The transaction hash is invalid or missing.

(2) A malformed URL is processed in some cases, but is indicated by error 0002.

0003

Cannot capture unauthorized payment.

0004

Cannot cancel/void unaccepted payment.

0005

Invalid amount.

0006

Cannot refund unaccepted payment.

0007

No payment type available.

0008

Hash has already been processed.

0009

Scoring invalid.

0010

Payment currently not available.

0011

Payment could not be finalized.

0012

Selected payment type is not available.

0013

API key mismatch.

0014

Cannot capture specified payment.

0015

Cannot cancel/void specified payment.

0016

Cannot refund specified payment.

0017

Invalid payment data.

0018

Missing parameter.

0019

Could not create the user.

0020

Username/email unavailable.

0021

Username or password invalid..

0022

Userauth token invalid.

0023

Could not connect the card to the user.

0024

Invalid value for parameter.

0025

Cannot process specified payment.

0026

Cannot create payment information.

0027

Invalid data.

0028

Payment Provider declined the payment.

0029

No transaction available for this terminal.

0030

Cannot create transaction.

0031

Unknown parking zone.

0032

The password you entered is too short.

0033

The passwords are not equal.

0034

The data provided is not sufficient.

0035

There was an error creating the API key.

0036

The license plate is not valid.

0037

Payment data missing.

0038

Cannot find any active ticket for this zone and car.

0039

There is already valid ticket for this car in this zone.

0040

There is not any tariff valid for your parking time.

0041

Password recovery failed.

0042

Your password has been recovered.

0043

Error recovering the password.

0044

Failed to save your payment data.

0045

Your payment data has been saved.

0046

Referenced payment is not accepted.

0047

Cannot set accrual.

0048

Cannot reverse accrual.

0049

Failed to add data.

0050

Your bank does not support SEPA direct debit.

0051

You are not approved for Subsequent.

0052

Subsequent posting already Available.

0053

The is already a subsequent posting.

0054

Amount too high.

0055

You are not approved for Refund.

0056

Missing or Invalid Parameter.

0057

Transaction not found.

0058

Refund amount higher than transaction amount.

0059

Invalid transaction status for refund.

0060

Payment type does not support refund.

0061

Refund amount higher than remaining transaction amount.

0062

Refund creation failed.

0063

Refund not implemented for payment type.

0064

You are not approved for getSubscription.

0065

Accrual not set for transaction.

0066

Selected currency is not available.

0067

This currency is not available for you.

0068

You have transferred disallowed characters.

0069

Refund amount does not match the available transaction amount.

0070

Total amount does not match the basket amount.

0071

Basket field name is not valid.

0072

Payment type of transaction_payout transaction does not support Payout.

0073

Invalid transaction status of transaction_payout transaction.

0074

Access denied to transaction_payout transaction.

0075

Basket has too many items.

0076

PIN wrong.

0077

The PIN was entered incorrectly too often.

0078

You have entered an incorrect telephone number (allowed characters are "+" and 0-9).

0079

Operation not approved for this project API key.

0080

You are not approved for this operation.

0081

Due to significant risk of fraud this user is rejected.

0082

The payment is already completed.

Other issues:

Problem

Explanation

The amount to pay, the article prices or the shipping fee is much less than expected.

Did you consider, that monetary amounts are passed in the smaller curreny unit?

If the currency is Euro (€), and you pass an amount or price of 495, this expresses €4.95. If you wanted to conduct a payment about €495.-, you would need to pass an amount of 495.