Sofort by Klarna

SOFORT is a third party means of payment by Klarna Group. To process SOFORT via the Saferpay JSON API a few things must be considered.

Sofortüberweisung/Sofort is no longer available, due to Klarna phasing out the product and replacing it with Klarna Payments. Thusly new integrations for Sofort are no longer possible.

Existing contracts will continue to work over the existing Integration with Saferpay.

This page is only for merchants, who already have Sofort integrated.

Important: Sofort by Klarna/Sofortüberweisung is NOT the same as Klarna Payments! Please refer to this chapter, if you want to use Klarna Payments!

Requirements

The handling of SOFORT payments with Saferpay requires:

• A corresponding license and thus a valid identification with a username and password for the Saferpay system.

• Availability of at least one active Saferpay terminal via which payment can be carried out and availability of the associated Saferpay TerminalId.

• A valid acceptance agreement for SOFORT must be present.

For SOFORT activation Saferpay needs:

• Your SOFORT Customer ID.

• The SOFORT Project ID.

• The SOFORT Project password (NOT the account password!).

• The Currency your customers will purchase with SOFORT.

• Your Saferpay Customer ID.

• The ID of the Saferpay eCommerce Terminal SOFORT is to be added.

For Sofort activation on the Saferpay terminal, please inform our customer service about your Sofort credentials (see list above) and the desired currencies.

Supported features

Feature	Support
Capture/Cancel	❌
Multipart Captures	❌
Secure Card Data	❌
Refunds	✅ Needs attention!
Recurring Payments	❌
3D Secure	❌
Dynamic Currency Conversion	❌
Mail Phone Order	❌
Testing	✅
Omni-Channel	❌

Integration

The general integration of SOFORT can only be done via the Payment Page and requires the following things to be noted:

• The notification URLs, inside theNotification conatiner are mandatory, in order to avoid missing payment successes. See the Payment Page process for further information.

• The Payment.OrderId is limited to 27 characters. Anything above that, will be trimmed.

• Sofort does not support the Iframe integration. Saferpay will break out of the IFrame, if necessary.

Sofort does not support the iFrame Integration!

Furthermore, for other flows (Refunds etc.), please refer to the table above.

Sofort/Klarna actively blocks the iFrame-Integration. In order to circumvent this issue, the Saferpay Payment Page will break out of the iFrame and display the Sofort website full-size, in order to make a payment possible. However, please keep in mind, that the ReturnUrls will also be displayed full-size!

Create a new project for SOFORT

Before you can accept SOFORT payments, you must create a Sofort project, following this guide:

1 - Log-in to your SOFORT member area. Choose „New project“ and click „Create project“.

(click to enlarge)

2 - Set the radio button for „Classic project“ and click again „Create project“.

(click to enlarge)

3 - In the next step specify general settings for the project.

(click to enlarge)

Don't forget to deactivate the Test mode before going live!

4 - Then enter your address.

(click to enlarge)

5 - Specify the currency for your customer’s payments.

(click to enlarge)

6 - Enter your IBAN for receiving your customer’s payments.

(click to enlarge)

7 - For processsing SOFORT payments via Saferpay enter the redirect links.

(click to enlarge)

Success link: https://-USER_VARIABLE_0-paymentStatus=ok-USER_VARIABLE_2--USER_VARIABLE_3--USER_VARIABLE_4--USER_VARIABLE_5--SENDER_IBAN- Abort link: https://-USER_VARIABLE_0-paymentStatus=cancel

Copy these values as they are here!

8 - Scroll downn and click on "Save" to save your general project settings. Click on the tab „Extended settings“ to configure additional project settings.

(click to enlarge)

9 - Go to „Shop interface settings“ in the "Extended settings" tab and enter the timeout value and link.

(click to enlarge)

Timeout in seconds: 900 Timeout link: https://-USER_VARIABLE_0-paymentStatus=timeout

Copy these values as they are here!

10 - Again click the tab „Extended Settings“ and choose „Notifications“.

(click to enlarge)

11 - Click „Add new notification“ and add your email address to receive notification messages.

(click to enlarge)

12 - Save and complete with adding the notification URL. As method choose „POST“.

Notification URL: https://-USER_VARIABLE_1-

13 - Finally create a project password. Click the tab „Extended settings“ again and there „Passwords and hash algorithm“. Select SHA-1.

(click to enlarge)

Please make sure to check the Don't use special characters-box! Otherwise it can cause major issues!

DO NOT create a notification-password, otherwise the server-to-server notification will not work, which may result in transactions not being visible in the Saferpay Backoffice.

The settings for processing SOFORT via Saferpay are completed!

For Sofort activation on the Saferpay terminal, please inform our activation service about your Sofort credentials (see list above) and the desired currencies.

Testing

Please refer to this chapter, if you want to test Sofort.