WooCommerce

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.

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

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 shows you how to integrate zahls.ch into WooCommerce.

Plugin installation

Log in to your WordPress admin.
Navigate to Plugins > Add New.
Search for zahls.ch Credit Cards, PostFinance and TWINT for WooCommerce.
Click Install Now, then Activate.

Alternatively, download the plugin as a ZIP and install it under Plugins > Add New > Upload Plugin.

Activate payment methods in zahls.ch

In your zahls.ch dashboard, go to Payment providers.
Activate Payrexx Pay and/or Payrexx Pay Plus as well as the desired payment methods.
We recommend at least TWINT, Mastercard, Visa, Apple Pay, Google Pay and PostFinance.

Details: Activating payment services.

Create an API key

In the dashboard, go to API and Integrations.
Click Add API key.
Enter a name (e.g. “WooCommerce”) and click Add.
Copy the API key — you need it in the next step.

More information: API and Integrations.

Configure WooCommerce

In WordPress, go to WooCommerce > Settings > Payments.
Open the zahls.ch payment method.
Configure the following settings:

Field	Description
Activate	Enable zahls.ch as a payment method.
Title	Label shown at checkout (default: “Credit Cards / TWINT”).
Description	Optional description at checkout.
Instance	Instance name of your zahls.ch account without `.zahls.ch`. If your URL is `example.zahls.ch`, enter only `example`.
API key	The API key from API and Integrations.
Look&Feel ID	Optional: Look & Feel ID for a specific checkout design. Leave empty if you only have one profile.
Prefix	Optional: prefix for the order reference if several shops share one zahls.ch account.
Logos	Select the payment method logos to display at checkout.

Save the settings.

Set up the webhook

For orders in WooCommerce to receive the correct status, create a webhook in zahls.ch:

In the dashboard, go to Webhooks.
Click Create webhook.
Enter the following webhook URL and replace the domain with your shop domain:

https://www.yourdomain.ch/?wc-api=wc_zahls_gateway

Select PHP-Post as the webhook content type.
Enable the Transaction event.
Save the webhook.

More information: Webhooks.

Subscriptions

To allow customers to purchase subscriptions at checkout, install and activate the WooCommerce Subscriptions plugin. Then enable recurring payments in the zahls.ch plugin settings.

Subscriptions distinguish between automatic and manual renewals:

Automatic renewal

The stored payment method is charged automatically 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.

Customer modifications

zahls.ch does not modify customer data in WooCommerce. If a customer is deleted or their subscription has disappeared, this may have been caused by the WooCommerce Subscriptions plugin or manually by a WordPress user.

Refunds

To refund the full or partial amount of a transaction, follow this guide:

Refunds and Partial Refunds

After you complete the refund in zahls.ch, it is automatically communicated to WooCommerce and shown in the order.

Order and Payment from the Customer’s Perspective

The following process outlines how a customer places an order and pays in a WooCommerce store with zahls.ch:

The customer selects a product and adds it to the shopping cart.
After reviewing the cart, the customer proceeds to checkout.
The customer selects the zahls.ch payment method (e.g. “Credit Cards / TWINT”).
The customer is redirected to the zahls.ch payment page, chooses a payment method and completes the payment.