WooCommerce

In this article, you will learn how to install the official plugin for WooCommerce and connect Payrexx with your WooCommerce shop.

Available for Wordpress 5.6 - 6.8 and WooCommerce 5.0 - 10.0.1

General Information

WooCommerce is an e-commerce tool that can be integrated into WordPress as a plugin. This open-source plugin allows merchants to add extensive e-commerce functionality to their website. With WooCommerce, you can manage shops, products, shopping carts, and payment processing, among other things.

Links

• WordPress Website

• WooCommerce Website

• WooCommerce Documentation

• Download Plugin

Features

• ✅ Multi-currency support

• ✅ Payment method icons in checkout

• ✅ Cart transmission

• ✅ Webhook functionality

• ✅ Look & Feel configuration

• ✅ Individual payment method configuration

• ✅ Subscription support

• ✅ Ability to process refunds

Please note that integration with WooCommerce is only available in the Standard and Premium plans. For more information

Payment methods

The following payment methods are supported by the WooCommerce plugin:

Payrexx Pay	Payrexx Pay Plus	External Payment Providers
Mastercard	Mastercard	Masterpass
Visa	Visa	PayPal
PostFinance Pay	American Express	Maestro
TWINT	Diners Club International	HeyLight
Apple Pay	Discover Card	WIRpay
Google Pay	Apple Pay	Boncard
Samsung Pay	Google Pay	PostFinance Card
Pay by Bank	Klarna	PostFinance E-Finance
Purchase on Invoice		Bill
Reka		POWERPAY
Crypto		CembraPay
		xMoney
		VERD

Integration

The following guide will show you how to integrate Payrexx into WooCommerce.

Configuration of Payrexx

Make sure you're logged in to your Payrexx account before you begin. If you don’t have a Payrexx account yet, you can register now.

• Navigate to the API & Plugins section in your Payrexx merchant administration.

• Under "Add e-commerce integration", click on "Show all".

• Click "Add" next to WooCommerce:

Start of WooCommerce integration

• In the next window, configure the following settings:

WooCommerce settings in Payrexx

1. API Key: Displays the API key used to connect with WooCommerce.

2. Instance Name: Displays the instance name of your Payrexx account.

3. Enter Shop Address: Enter the URL of your shop in this field. If your shop is not in the root directory (https://my-website.xy) but in a subdirectory, please provide the full path to your shop. Example: https://my-website.xy/shop

Please make sure that you enter the shop URL correctly. Any discrepancies (e.g. using http:// instead of https://) can cause errors in webhook processing.

1. Webhooks: Specify whether a failed webhook should be retried or not. If this checkbox is activated, the system will attempt to resend the webhook up to 10 times. The retry intervals are 5 minutes, 15 minutes, 1 hour, 2 hours, 4 hours, and then every 24 hours thereafter.

2. Finalize: Click the green "Activate" button to finalize the configuration.

Plugin installation

Log in to your WordPress account before you begin.

• Navigate in your WordPress account to Plugins > Add Plugin.

• Search for the plugin "WooCommerce Payrexx Payment Gateway".

• Click on the "Install Now" button:

Installing the Payrexx plugin

• Click on the blue "Activate" button:

Activating the plugin in WordPress

Configuration of WooCommerce

• Navigate in your WordPress account to WooCommerce > Settings.

• Click on the "Payrexx" tab.

• Establish the connection between WooCommerce and Payrexx:

Connecting WooCommerce with Payrexx

Establish Connection Automatically:

• Select the platform you are using. Usually, this is "Payrexx" (1).

• Enter the instance name. If your URL is beispiel.payrexx.com, then your instance name is beispiel (3).

• Click on "Connect" (2), and you will be redirected to Payrexx.

• Log in to your Payrexx account:

Login to Payrexx

• After logging in, Payrexx and WooCommerce will be automatically connected:

Successful connection between Payrexx and WooCommerce

Additional settings

• Look & Feel Profile ID: If you have multiple Look & Feel profiles in Payrexx, you can specify which one to use by entering the desired profile ID here. If you only have one Look & Feel profile, you can leave this field blank.

• Prefix: This field only needs to be filled in if you are a Payrexx platform customer managing multiple shops within one Payrexx account. Each shop plugin sends an order ID as a reference to Payrexx. The prefix ensures that Payrexx knows which shop the transaction belongs to.

Configuration of payment methods

• Navigate in your WordPress account to WooCommerce > Settings.

• Click on the "Payments" tab and make the following settings:

Payment method management in WooCommerce

1. Activating and deactivating payment methods: To enable or disable a payment method, click on the three dots and then on "Enable" or "Disable".

2. Manage: Click on "Manage" next to the desired payment method to make further settings:

Additional settings for a payment method (example: Visa)

1. Enable/Disable: Decide whether this payment method should be available during checkout.

2. Title: Specify the title or name of the payment method.

3. Description: Optionally, enter a description of the payment method.

4. Enable/Disable Subscriptions: Choose whether this payment method can be used for subscriptions (recurring payments).

Please note that recurring payments only work if the WooCommerce Subscriptions plugin is activated.

1. Description Checkbox: Enter a description which the user sees besides the checkbox to activate recurring payments for a subscription. The checkbox is only shown if the feature is active and a subscription has been purchased.

2. Save Changes: Click on the blue button to save your settings.

Subscriptions

To allow your customers to purchase subscriptions during checkout, you need to install and activate the plugin "WooCommerce Subscriptions":

WooCommerce SubscriptionsWooCommerce

For subscriptions, there is a distinction between automatic and manual renewals:

Automatic renewal

The payment method provided by the customer is automatically charged when a new subscription payment is due. Automatic renewals are only supported by certain payment methods.

Manual renewal

The customer receives an email with a payment link when a subscription payment is due. Manual renewals are supported by all payment methods available in Payrexx Pay and Payrexx Pay Plus.

For more information on automatic and manual renewals, please refer to the WooCommerce documentation:

Subscription Renewal ProcessWooCommerce

If you do not want to allow recurring payments, you can disable the subscription feature under WooCommerce > Settings > Subscriptions.

Customer modifications

Payrexx does not make any modifications to customer data in WooCommerce. If a customer is deleted or their subscription has disappeared, this may have been caused by the Subscriptions for WooCommerce plugin or manually by a WordPress user.

Refunds

Please note that refunds and partial refunds must be performed in Payrexx. Refunds initiated in WooCommerce are not communicated to Payrexx.

To refund the full or partial amount of a transaction to a customer, please follow these steps:

Refunds and Partial Refunds

After you have completed the refund in Payrexx, it will be automatically communicated to WooCommerce and displayed accordingly in the order.

Order and Payment from the Customer’s Perspective

The following process outlines how a customer places an order and makes a payment in a WooCommerce store integrated with the Payrexx payment solution:

• The customer selects a product and adds it to the shopping cart:

Adding a product to the cart in WooCommerce

• After reviewing their shopping cart, the customer proceeds to the checkout:

Proceeding to checkout in WooCommerce

• The customer selects their preferred payment method from the list (Visa in the following example):

Selecting the payment method in WooCommerce

• The customer is redirected to the Payrexx payment page to complete the transaction:

Completing the payment

The payment in the WooCommerce store is successfully completed.