English

Shopware 6 User Guide - English

Saferpay Plugin for Shopware 6

Requirements

  • Shopware Version 6.4.x.x - 6.5.x.x

  • Saferpay account with at least one eCommerce terminal

  • Saferpay API Credentials (Customer-ID, Terminal-ID, JSON API Username and Password)

  • Valid acceptance contracts for the payment methods to be used

Installation and Activation

  • Log in to the Shopware 6 backend.

  • Navigate to: Extensions--> My Extensions --> Apps -->Upload extension and upload the plugin or install the plugin via your Shopware account

  • Open the context menu via the "..."-button and click the button Install.

  • Under My extensions --> Apps you can activate the plugin via the corresponding switch.

Configuration

General settings

  • Click the button with the three dots (…) on the right side and select Configure to get to the plugin configuration.

  • At Operation Mode select either "Live" or "Test", depending on which Saferpay environment you want to use (see https://docs.saferpay.com/home/integration-guide/testing-and-go-live).

  • At Merchant email addresses, enter a comma-separated list of up to 10 email adresses that should receive a confirmation email after successful payment authorization.

  • At Theme you can select a theme to customize the appearance of the payment page.

  • At Payment Page-Configuration you can specify the payment page configuration you want to use by entering the of the corresponding configuration (see https://docs.saferpay.com/home/features/payment-page-configuration).

  • At the configuration section Payment API (JSON API) live credentials you enter the data of your Saferpay live account (Customer-ID, Terminal-ID, JSON API Username, JSON API Password), which should be used if the operation mode "Live" is selected.

  • At the configuration section Payment API (JSON API) test credentials you enter the data of your Saferpay test account (Customer-ID, Terminal-ID, JSON API Username, JSON API Password), which should be used if the operation mode "Test" is selected.

Add payment methods

After you have made the general settings for the Saferpay plugin, you need to configure the payment methods you want to support:

  • Go to Settings--> Payment methods in the Shopware 6 admin area.

  • All payment methods supported by the Saferpay plugin will now appear here.

  • Open the details of the payment methods you want to use.

  • Activate the payment methods

  • In the section Custom fields in the tab Saferpay you can use various fields to configure the payment method.

  • At Payment means you can explicitly set which means of payment should be available on the Saferpay payment page when this payment type is selected in the storefront. Please note that the payment method must also be activated in the Saferpay terminal. If you leave this field empty, all payment methods available in the Saferpay terminal will be offered.

  • If 3D-Secure (https://docs.saferpay.com/home/integration-guide/3d-secure) is supported by the payment methods, you can set at Liability shift behavior whether the payment should be aborted if no liability shift is granted or whether the payment should be accepted anyway.

  • At Wallets you can set which wallets should be available on the Saferpay Payment Page when this payment type is selected in the storefront. Again, the payment type must be enabled on the Saferpay terminal. If you leave this fields empty, no wallets will be offered

  • Note that all configurations can be configured individually for each Shopware language. By default, all fields are empty for all NON-standard languages. If a field is empty in a NON-standard language, the value is taken from the standard language.

Setting up the Checkout Page

Last but not least, the payment methods must be assigned to the sales channels so that customers can select them in the checkout process. To do this, proceed as follows:

  • Navigate to Sales Channels in the Shopware 6 admin area.

  • Select the sales channel for which you want to activate the payment methods.

  • In the section Payment and shipping, assign the Saferpay payment methods you want to use for this sales channel.

After assigning the payment methods to the sales channels, the corresponding Saferpay payment methods are available in the storefront.

PreviousShopware 6 User Guide - GermanNextShopify

Last updated