Integration Guide

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.