Shopware

With Volt, your customers can check out from their banking app on mobile or online banking on desktop. You can install Volt: Pay by Bank from the extension marketplace. Volt is compatible with Shopware v5 and v6. 

Step 1: Get access credentials to the Volt merchant portal (Fuzebox)

In order to start using Volt payments, you first need to get a set of access credentials. These consist of your Volt customer credentials and application credentials. You will be able to generate them via the Volt merchant portal (Fuzebox). Volt team will enable your access to the portal by creating an account for you.

Generate the API username and password (NOT your username and password for Fuzebox)

  1. Login to Fuzebox.
  2. Generate customer credentials.
  3. Store your username safely AND copy-paste it into Merchant Username field.
  4. Store your password safely AND copy-paste it into Merchant Password field.

Generate the client id and secret.

  1. In Fuzebox register an application to receive your client id and secret. NOTE that the Payment return URLs are ineffective and you can set them to your main page or any other general URL.
  2. Store your client id safely AND copy-paste it into Client ID field.
  3. Store your client secret safely AND copy-paste it into Client Secret field.

Please note that you should copy all credentials from Fuzebox immediately and securely store them. The customer password will be encrypted once you close the window. 

Step 2: Install Volt: Pay by Bank

Find Volt: Pay by Bank app in the Shopware extension marketplace. You can also follow the link to access the plugin for Shopware 5 here

Please note that there are slight differences in configuring Volt on Shopware 5 and Shopware 6. 

Step 3: Authorisation in the Shopware admin portal 
  1. Log into your Shopware admin panel.
  2. Navigate to Configuration > Plugin Manager and enter the earlier-generated credentials into the fields outlined in the screenshot below. You can configure Sandbox (test) and Production separately. At the same time, only one environment can be activated. To enter Sandbox credentials, select “Yes” (or “True” depending on your Shopware store version) for the Sandbox field. To enter Production credentials and start processing real transactions with Volt, select “No” (or “False” depending on your Shopware store version) for the Sandbox field. API Username and API Password are the Username and Password from Fuzebox> Customer> Credentials tab; Client ID and Client Secret are the Client ID and Client Secret from Fuzebox> Applications tab.
  3. Enable the logs by selecting “Yes” (or switching the toggle depending on your Shopware store version). If this setting is enabled, different levels of information will be saved in a custom log file, for example, details on errors. It is strongly recommended to enable them.
  4. You can test the API Connection to Volt based on the credentials pasted. This will allow you to check if the credentials are successfully authenticating to Volt API. This step is optional.
  5. Copy the Notification Secret Key.
  6. Click “Save”.

All configurations are inherited for every subshop / language shop, except for the Sandbox configuration, which can be changed per subshop.

Step 4: Notification setup
  1. Go back to Fuzebox> Applications and access the Notifications section. 
  2. Configure the settings as explained in the guide. The webhook URL should be set to: https://dev2.sw5.426.agency/VoltCheckout/notify if you are using Shopware 5 and to https://dev3.sw6.426.agency/voltPayment/notify if you are using Shopware 6. To configure the Payment return URLs please follow the following format: {domain}/webhook URL.