Swedbank Pay Payment Menu is a plugin that extends WooCommerce, allowing you to take payments via Swedbank Pay.

The plugin can be downloaded for free here.

Sign up with Swedbank Pay

To get started with Swedbank Pay Payment Menu, you need to create an account with Swedbank Pay. If you’re not a customer yet you can get in touch with Swedbank Pay through this link.

Installation

From WordPress repository

• Login to WordPress Admin. Navigate to Plugins → Add Plugin (in the left column menu).
• Search for Swedbank Pay Payment Menu in the search bar and click the Install Now button when Swedbank Pay Payment Menu appears.
• Activate the plugin.

From downloaded plugin file

• Download the plugin as a .zip-file from WordPress.org.
• Login to WordPress Admin. Navigate to Plugins → Add Plugin (in the left column menu).
• Click on the Upload Plugin option, then click Browse to select the zip file from your computer. Once selected, click OK and then click the Install Now button.
• Activate the plugin.

Required WordPress/WooCommerce settings

• You need to enable HTTPS (install a SSL/TLS certificate) in your web store to get Swedbank Pay Payment Menu to work.
• Make sure that you have enabled pretty permalinks in your WordPress installation. Otherwise callbacks from Swedbank Pay back to your store won’t work and orders will not be updated with the correct order status/information.
• It’s important that callbacks from Swedbank Pay Payment Menu to your store doesn’t get blocked by security or caching plugins. Make sure that requests to https://yourdomain.com/wc-api/ isn’t blocked.
• To get the order total to match between WooCommerce and Swedbank Pay you need to configure WooCommerce to display prices with 2 decimals. More information about displaying of prices and how it can cause rounding issues can be found in this article.

Configuration

Navigate to → WooCommerce → Settings → Payments → Swedbank Pay Payment Menu

Basic settings

1. Enable Swedbank Pay Payment Menu by checking the Enable plugin checkbox.
2. Test mode – Tick the Enable Swedbank Pay Test Mode checkbox if you make purchases using the test credentials.
3. Title – Enter the title for the payment method displayed in the checkout and order confirmation emails.
4. Description – Enter the description of the payment method displayed in the checkout page.
5. Payee Id – Enter your Payee Id, which can be found in our Merchant-portal here.
   Make sure you are using test credentials if you have Test mode enabled.
6. Access Token – Enter your Access Token, which can be found in our Merchant-portal here.
7. Language – Set the language of the pages displayed by Swedbank Pay during payment.
8. Instant Capture – Choose which product types should be captured instantly. Works only when Automatic order status is turned off.
   Read more about this setting.
9. Terms & Conditions URL – Enter the URL to your Terms & Conditions. HTTPS is required.
10. Logo URL – Enter the URL of the logo to display in the payment menu. Recommended size is 50px high and 400px wide. HTTPS is required for the URL.
11. Automatic order status – Check this box if you want to set your orders to Completed status immediately after payment.
    Read more about this setting.
12. Exclude order lines – Enable this setting to prevent order line data from being sent.
13. Checkout Flow – Choose your preferred checkout flow; Redirect Menu or Seamless Menu. When using the Block Checkout, only Redirect Menu is supported currently.

Please note that there is a technical restriction in the Seamless Menu checkout flow where it only submit the Merchant reference, and not the Order reference, to Swedbank Pay. You can read more about this in the Known issues section.

Order management

1. Capture on status change – Check this box to automatically capture the payment when the order status is changed to Completed in WooCommerce.
2. Cancel on status change – Check this box to automatically cancel the payment when the order status is changed to Cancelled in WooCommerce.

Troubleshooting

1. Logging – Check this to enable logging and save debug messages to the WooCommerce System Status log. Logging is required for troubleshooting any issues related to the plugin. It is recommended that you always have it enabled.
2. Detailed logging – Enable detailed logging to capture extra data. Use this only when needed for debugging hard-to-replicate issues, as it generates significantly more log entries.
3. Enable International Telephone Input – Check this box to enable International Telephone Input. This enhances the phone field with an international input: adds a country flag dropdown, detects the user’s country, shows the correct placeholder, and validates the number format

Instant capture

With this setting, you can decide which product types (if any) should trigger an instant capture when an order is placed.

Please note that this setting requires Automatic order status to be disabled.

This setting only applies to orders that are placed and then set to On hold in WooCommerce.

When activated, the plugin checks whether any of the configured product types are included in the order. If at least one matching product type is found, the plugin attempts to capture the entire order amount in Swedbank Pay’s system.

Even though the payment is captured successfully in Swedbank Pay, the order will remain in On hold status within WooCommerce. The status will need to be managed manually or through additional automation.

Automatic order status

The Automatic Order Status setting determines how WooCommerce order statuses are updated after checkout.

When enabled, the plugin checks the order status once the customer reaches the Thank You page. This check is also performed in the callback, if something happens and the customer never reaches the Thank you page.

When Automatic order status is enabled, the order will be finalized regardless of its WooCommerce order status. This means the plugin will always attempt to capture the payment, and the WooCommerce order will be set to Completed.

When Automatic order status is disabled, the order status will follow WooCommerce’s default behavior. Typically, this results in the order being set to Processing (for physical goods) or Completed (for downloadable virtual products only).

Subscription support

Swedbank Pay Payment Menu is compatible with the WooCommerce Subscriptions extension for handling recurring payments.

Read more about recurring payments with Swedbank Pay here.

Currencies

The plugin itself has no limitations regarding currency.

However, please note that there can be limitations in the agreement you have with Swedbank Pay.

When it comes to questions regarding supported currencies you should always talk to your payment provider.