Shopware6

Information

Set-up

Installation

You can easily install the plugin via Shopware's plugin manager. Have your credentials ready.

1. In the Shopware 6 Admin panel, navigate to Extensions > Store and type "Pay." in the search bar.
2. Select the plugin by clicking on the image and then** Add extension**
3. The plugin should now be visible under Extensions >** My extensions**
4. Toggle the slider from Deactivated to Activated by clicking it
   _It is automatically set to deactivated _

Configuration

After the installation is complete, start accepting payments by doing the following. Have your credentials ready.

1. In the Shopware 6 Admin panel, open the plugin via: Settings > Extensions >** Pay. payments** or Extensions > **My Extensions **> ... > Configure
2. Fill in the following details:
3. Token-Code (AT-xxxx-xxxx)
4. API-token (a3e314ee...)
5. Service-ID ((SL-xxxx-xxxx))
6. Select **Install payment methods ** to load all payment methods activated in your sales location
7. Configure your plugin and click the Save button to save your changes

👍

You have now successfully connected your Pay. account to Shopware

Releases

Features

iDEAL Fast Checkout

In order to use iDEAL Fast Checkout, please install the latest version of our Shopware plugin.

This feature will show a Fast Checkout button for iDEAL on the cart page and/or minicart.

To activate this:

1. Go to Settings > Shop > Payment Methods > iDEAL | Pay. payments
2. Enable** Cart page **and/or Minicart by clicking on the toggle, depending on where you want the button to be displayed

1. Cart page

2. Minicart

3. Save your changes by selecting** Save**

PayPal Checkout

In order to use PayPal Checkout, please install the latest version of our Shopware plugin.

This feature will show a Fast Checkout button for PayPal on the cart page and/or minicart.

To activate this:

1. Go to Settings > Shop > Payment Methods > PayPal | Pay. payments
2. Enable** Cart page **and/or Minicart by clicking on the toggle, depending on where you want the button to be displayed and **enter your PayPal credentials **

1. Cart page

2. Minicart

3. Save your changes by selecting** Save**

Refunds

It is possible to create refunds directly in the Shopware backoffice. Full and partial refunds can be added by entering an amount or using the product list. You will need to activate this option (Allow refunds) in the plugin.

1. In the Shopware 6 Admin panel navigate to Orders > Overview
2. Click on the three dots ** ...** to the right of the order you want to refund
3. The Refund Payment Page will open. You now have various options to process your refund:
4. Refund
5. Amount to refund: €39,95 This amount is automatically filled with the total order amount, you can edit this amount for partial refunds.
6. Description: My first refund! Description of the refund which you can use as a reference (this will not show in Pay.)
7. Product list
8. Refund: via the dropdown, you can select the amount of products to refund on product level. The "Amount to refund" at the top is automatically adjusted
9. Restock: check this box to revert the stock
10. Shipping
11. Allow shipping refund: when you select this checkbox, it is also possible to refund the shipping costs
12. Click on Refund to refund the amount. You will receive a notification "Refund Successful" to let you know your refund has been processed correctly.

Capture (BNPL)

When you offer Buy Now Pay Later payment methods in your checkout, the idea is to invoice your customers after they have received their products or services.

Example:

customer places order > transaction status is AUTHORIZED > webshop ships the product(s) > CAPTURE is created

In this plugin, it is possible to automate this flow.

Under Extensions > My Extensions > ... > Configure you will see the Auto-capture settings.

Automatic Capture based on Shipment status: when enabled, the plugin will automatically send a capture (payment) notification to Pay. when the delivery status changes to 'shipped'. This applies to transactions in state AUTHORIZE.

Automatic Cancellation based on Order status: when activated, the plugin will automatically void a transaction in Pay. when the order status is changed to 'cancelled'. This applies to transactions in the state AUTHORIZE.

Google Analytics

Ensure you have activated the Google Analytics function in My Pay.

It is possible to connect your Google Analytics Account to Shopware 6. This setting in the Pay. plugin ensures the ga_Id is sent with the transaction to improve conversion tracking.

1. Activate Google Analytics in Shopware via** Sales Channel** > Analytics and enter your tracking ID, also activate the toggle "Activate Google Analytics"
2. Go to the Pay. plugin and activate the option** Transfer analytics to Pay.** by clicking the toggle

Paylink

To send payment links, the order will have to be created in the backoffice. A customer will not be able to select this payment option themselves in the checkout.

1. In the Shopware 6 Admin panel navigate to Orders > Overview >** Add Order **
2. Fill in all the customer and product details. Under the tab "Options", select the relevant payment method
3. After completing all the information select Save Order
4. Your customer will receive an email with a link to their order, see example below
5. The customer visits this link and can make a payment by selecting Complete payment
6. The customer will be redirected to the "Checkout" to complete the payment as normal

Instore

1. Go to Stores > Configuration > Sales > Payment methods
2. Search for Instore(PIN) and make sure Enabled is set to Yes
3. Now go to the plugin via Settings > Extensions >** Pay. payments** or Extensions > **My Extensions **> ... > Configure
4. Under PIN payment select either:
5. **Choose in checkout **- enduser can select a card terminal themselves, via a dropdown menu in the checkout screen
6. Choose in checkout and save - card payments always start on the same card terminal (customer cannot change this)

Surcharge

Please note that a <<glossary:Surcharge>> is not always allowed.

1. In the Shopware 6 Admin panel, open the plugin via: Settings > Extensions >** Pay. payments** or Extensions > **My Extensions **> ... > Configure
2. Activate Surcharge payment methods by clicking the toggle, this adds a new menu to the payment methods
3. Go to Settings > Shop >** Payment methods** to apply surcharges on a payment method
4. Type
5. Absolute: fixed value. The value is set in the field "Amount".
6. Percentage: percentage. The value is set in the field "Amount".
7. Amount
8. Fixed value: for €0,50 you enter 0.5. NB: the amount includes VAT (this is automatically applied in the cart/checkout by Shopware using the default tax settings of the webshop).
9. Percentage: for 2% you enter 2.
10. Surcharges not applied on orders totalling more than
11. Surcharges will not be applied to orders totalling more than the amount entered. For example, you can enter 200 for €200.

Business Orders

Certain payment methods, like Biller, can only be used with B2B orders. For these payment methods, you can select:

Show payment method only for businesses

1. In the Shopware 6 Admin panel, go to Settings > Shop > Payment methods
2. Go to the relevant payment method and click **Edit details **
3. Under Availability rule you will see a dropdown. Set this to Commercial only, for example to only show the payment method for commercial customers only
4. Click Save to save your changes

Show COC and/or VAT field in checkout

1. In the Shopware 6 Admin panel, open the plugin via: Settings > Extensions >** Pay. payments** or Extensions > **My Extensions **> ... > Configure
2. Go to **CoC number required **and activate this option by selecting the toggle, to make this a required field

Additional information

In the checkout, the payment method will only appear, when the customer has confirmed they are a commercial customer via the dropdown** I am: Commercial/Private**

Not seeing this option? Activate this option via Settings > Shop > Login / Registration and activate the option **Show selection between company and customer account **

1. Allow payment change after checkout: indicates whether this payment method should be available after a payment is cancelled or denied. For example, you might not want to show Buy Now Pay Later methods and/or credit card options, if the customer was denied by a payment option already.

Additional customer fields

Here we explain how you can set additional fields in the customer registration form. You can make certain fields mandatory, which can be useful for processing your orders and customer data.

1. In the Shopware 6 Admin panel, go to Settings > Shop >** Login / Registration**
2. Here you can set the fields you would like to use on the Customer Registration page
3. Click on Save to save your settings

Translations

You can manage the payment method name, description and translations yourself in Shopware.

1. Go to Settings > Shop > Payment method > Edit details of the relevant payment method. You can update:
2. Title: name as shown in checkout
3. Description: additional information that is shown in the checkout for this payment method
4. To change the translations, simply switch between languages at the top right (next to the cancel button)

Multicore

To limit the impact of a Single Point of Failure (SPOF), we make it possible to use multiple cores in our Magento2 plugin. We will explain how here:

1. In your Shopware6 admin panel, go to: Settings > Extensions > Pay. payments or Extensions > **My Extensions > ... **(next to Pay. payments) > Configure
2. Under Advanced Settings you will see a dropdown next to Failover gateway. Choose between:
3. Pay.nl (Default) - this is the GMS API (rest-api.pay.nl) and is selected by default
4. Achterelkebetaling.nl - this is a TGU and can be used when the GMS is unavailable
5. Payments.nl - this is a TGU and can be used when the GMS is unavailable
6. Custom - set your own URL, in the same format as the example NB: the alternative cores can be used for starting transactions and retrieving their status only.
7. Click **Save ** to save your changes

Look out for this setting:

Simply select an option from the dropdown menu:

📘

The idea behind the multicore is that your transaction processing is never interrupted. The multicore is, therefor, available for the endpoints transaction::start and transaction::info/status only. Non-essential processes (like the getService, refunds etc.) can continue once any disruptions have cleared.

Returnless

As of version 1.6.9 we support Shopware's native refund API which is used by partners such as Returnless.

When you have installed both Returnless and Pay's extension. You can create a refund automatically after creating a return by going to:

1. Go to Returnless portal
2. Create Credit Invoice (or Refund) and select "Mark as done"

3. If you do not select Mark as done in the step above, you can manually adjust the refund status by going to the Shopware admin > Orders (open the relevant order) > Returns > change return status from **In Progress **to Done

Payment method settings

It is possible to change a few settings via Settings > Shop > **Payment method **.

• Name: name as shown in checkout
• Position: to determine the ranking in checkout. Enter -100 (for example) to show this payment method at the top of your list. The smaller the number, the high up in the ranking they will appear.
• Description: description as shown in the tooltip. You can include instructions here, for example for bank transfer.
• Logo: change the logo as shown in the checkout.
• Active: indicates whether the payment method is available in the checkout.
• Allow payment change after checkout: indicates whether this payment method should be available after a payment is cancelled or denied. For example, you might not want to show Buy Now Pay Later methods and/or credit card options, if the customer was denied by a payment option already.