Payer simplifies payments between companies. Their service for e-commerce helps create an amazing buying experience, that creates happy customers and increased revenue.
Payer offers a wide range of different payment solutions that you can easily use in your store.
Account with Payer
To use the Payer plugin you need an account with Payer. This will provide you with the different keys that you need for the plugin to work correctly. You can contact Payer and get more information about this here at https://www.payer.eu/
The plugin itself has no limitations regarding currency.
However, please note that there can be limitations in the agreement you have with Payer.
When it comes to questions regarding supported currencies you should always talk to your payment provider. The exception is when the plugin in fact do have limitations.
You can read more about this at the Payer website.
Required WooCommerce settings
- Make sure that you have enabled pretty permalinks in your WordPress installation. Otherwise callbacks from Payer back to your store won’t work and orders will not be updated with the correct order status/information.
- Make sure that the WooCommerce callback API works. If you enter the following address in a browser –
https://yourdomain.com/wc-api/Payer_Gateway– you should see a white page with -1 printed in the top of the page. If you get a 404 error message and have a multilingual plugin like Polylang installed, make sure to check the box Hide URL language information for default language in URL modification settings.
- To get the order total to match between WooCommerce and Payer 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.
Please note that Payer for WooCommerce does not have support for PHP 8.
- Login to WordPress Admin. Navigate to Plugins → Add New (in the left column menu).
- Click Upload Plugin and then browse to the plugin zip-file on your computer. Click on OK and finally click on the Install Now button.
- Activate the plugin.
These initial basic settings are all available for each Payer payment method (card, bank, invoice, installment, Swish, Einvoice and Masterpass). We use Card payment as an example here:
- Go to: WooCommerce > Settings > Payments > Payer Card
- Enable Payer card payments by checking the Enable Payer Card checkbox.
- The Title and Description fields controls what the customer sees during checkout.
- The Icon URL field can be used to replace the default Payer icon.
The following fields should be entered in the Payer Card section but they do apply for all payment methods:
- Enter the Agent ID, Soap ID, Soap Password, Post key 1, Post key 2 & Rest key that you have received from Payer.
- Enable order management – Check this to activate order management for Payer
- Enable get address – Check this box to enable the Get address feature from Payer. Note that this is only available in Sweden.
- Enable Proxy if you are using a proxy to prevent callback issues.
- Skip ID Validation – Enable if you wish to skip ID Validation. Please note that there might be a high security risk in doing so.
- Test mode – Check this box if you have a test account and want to make purchases against Payers test server environment.
- Debug – Check this box to log events for debugging. You can find the logs by navigating to WooCommerce → Status → Logs.
When an order is created in WooCommerce, and a reservation or transaction number exists in Payers system, you can manage the order in Payer directly from WooCommerce.
Get started with order management
To get started with order management, activate the setting Enable order management in the modules settings.
Activate an order
- Order status in WooCommerce must be Processing and a transaction ID must be saved in the order.
- Navigate to the order you wish to activate by going to WooCommerce → Orders and clicking the order.
- In the order details, select the field labeled Status. Set this to Completed.
- Click the button labeled Update in the top right of the page.
If the activation was successful, a Order updated with Payer note is added to the order. Followed by Invoice created with Payer for example, if the order is made with invoice.
Refunding an order
- Order status in WooCommerce must be Completed and a transaction ID must be saved in the order.
- Navigate to the order you wish to refund by going to WooCommerce → Orders and clicking the order.
- In the Order items box, press the Refund button.
- Here you can choose to refund the full sum for an item (1), part of the sum (2) or shipping (3).
If you enter a sum manually (2) you also need to enter the correct tax to refund manually, as opposed to when you refund the full sum for an item in which case the tax is automatically calculated. With shipping (3) you need to enter the amount manually, as well as the tax. Not to be confused with the Refund manually button.
- Click Refund via Payer B2B
If the refund was successful, a note is added to the order with the text X refunded with Payer.
We now support recurring payments through WooCommerce Subscriptions.
To activate this feature you need to:
- Set up an agreement with Payer about taking subscription payments.
- Purchase and configure the WooCommerce Subscriptions extension.
- Have Card payments or Direct invoice payments enabled in your store through Payer.
Payer only supports Card payments and Direct invoice payments for recurring payments.
If the checkout is not showing after you have followed all the instructions, and you don’t see any error messages in the checkout page, we recommend that you temporarily enable WP_DEBUG. You can find more information about that here.
Payer integrates with the normal checkout of WooCommerce and should work with most other plugins with few issues.
Compatibility with themes & plugins
- Payer uses its own template file for displaying the checkout page and should work with most themes. However, the plugin is only tested with the Storefront theme and we do not guarantee that it will work with other themes. Common situations when errors occur are:
– Themes/plugins with customized template files for WooCommerce checkout page.
– Themes/plugins that modifies the checkout into a multi step checkout.
If your theme is not mentioned above we recommend that you try the plugin first on a test store, and not in a live environment. If you need changes to be done then we recommend that you contact the developers behind your store.
Krokedil and Payer do not offer help with adapting your theme or plugin within regular support.