OnlineÜberweisen

OnlineÜberweisen is our own online banking based payment solution for online shops. Your customers can pay easily and conveniently by providing one-time access to the online bank account to initiate the payment. This means that Tink Germany is a purely technical service provider and is not involved in the actual cash flow. Therefore no additionals registration would be needed. As a merchant, you receive your money directly from the end customer.

Basic integration

View the full technical documentation of this product here.

Authentication

All authentication in our API is done via HTTP basic authentication.

HTTP

POST /api/v1/payments HTTP/1.1
Host: api.onlineueberweisen.com
Content-Type: application/json
Authorization: Basic base64("api:YOUR_API_KEY_GOES_HERE")
Cache-Control: no-cache

cURL

curl --user api:<my_api_key> https://api.xs2a.com/v1/payments

Initialize a Payment

HTTP

POST /v1/payments HTTP/1.1
Host: api.xs2a.com
Content-Type: application/json
Authorization: Basic base64("api:YOUR_API_KEY_GOES_HERE")
Cache-Control: no-cache

{
  "amount": 10.5,
  "currency_id": "EUR",
  "purpose": "Order ID: 1234",
  "metadata": {
    "key1": "value1",
    "key2": "value2",
    "key3": "value3"
  },
  "language": "de",
  "sender": {
    "holder": "John Doe",
    "iban": "DE04888888880087654321",
    "bic": "TESTDE88XXX",
    "bank_name": "Test Bank",
    "country_id": "DE"
  },
  "success_url": "https://example.com/success",
  "abort_url": "https://example.com/abort",
  "webhook_url": "https://example.com/webhook",
  "payform_code": "default",
  "iframe_top_forwarding": true
}

As result, you will get information about the created payment.

JSON

{
  "amount": 10.5,
  "currency_id": "EUR",
  "purpose": "Order ID: 1234",
  "metadata": {
    "key1": "value1",
    "key2": "value2",
    "key3": "value3"
  },
  "language": "de",
  "sender": {
    "holder": "John Doe",
    "iban": "DE04888888880087654321",
    "bic": "TESTDE88XXX",
    "bank_name": "Test Bank",
    "country_id": "DE"
  },
  "success_url": "https://example.com/success",
  "abort_url": "https://example.com/abort",
  "webhook_url": "https://example.com/webhook",
  "payform_code": "default",
  "iframe_top_forwarding": true
}

Integration as redirect

If you integrate the payment form as a redirect the only thing you have to do is using the URL from the X-Payment-Form header and forward your customer to that URL. With this method, the customer will leave your checkout page but will be redirected back to your service after finishing or aborting the transaction.

Seamless integration

To keep your customer at all times on your website you need to use the seamless iframe integration method.

For this method, you will also need the URL from the X-Payment-Form header. In addition to the URL, you need to add the following two lines to your website.

HTML

<div id="payform" data-start-url="https://admin.onlineueberweisen.com/wizard/78f2f915-b9ff-4e21-95c9-abcec5710fd5"></div>
<script type="text/javascript" src="https://wizard.onlineueberweisen.com/js/payment.js"></script>

Please substitute the data-start-url attribute with the content of the X-Payment-Form header.

Security Checks (optional)

To minimize your risk of non-payment, we offer you the option of security checks, which can be carried out based on various defined parameters and performed by our system.

Customized payment form (optional)

The payment form can be customized via our merchant portal. The customized payment form can be used within the framework of the product Payform as well as Pay Code. The adapted payment form can be used within the payform and paycode products.

PayPerCode (optional)

With the help of the PayPerCode product, one-time access to the online transfer function of a bank account can be used to set up a predefined transaction. This can take place under consideration of important risk and fraud criteria (security checks).

Account reconciliation (optional)

We also offer a reconciliation service from our side, to get more information please follow the link below.

Automatic Recon OnlineÜberweisen