WooCommerce plugin guide

This guide connects a WooCommerce shop to FlowAlp Pay from start to finish: activating the integration in the dashboard, installing and connecting the plugin, mapping payment methods, and validating everything with a test order. The plugin brings multi-currency support, payment method icons in the checkout, cart transmission, webhook status updates, look-and-feel configuration, per-method settings, subscription support and refund synchronisation.

Requirements#

• A current WordPress and WooCommerce installation — the plugin listing states the exactly tested version range
• A FlowAlp Pay account with dashboard access at https://pay.flowalp.com (create your account)
• The WooCommerce integration available in your dashboard — availability depends on your account configuration
• A publicly reachable storefront served over HTTPS with a valid certificate

Step 1 — Activate the integration in FlowAlp Pay#

1. Sign in at https://pay.flowalp.com and open API & Plugins.
2. Under Add e-commerce integration, click Show all and add WooCommerce.
3. The panel displays the API key issued for this connection and your [instance name](/docs/flowalp-pay-instance-name-en/).
4. Enter the shop address — the exact storefront URL. If the shop lives in a subdirectory, include the full path, e.g. https://my-website.example/shop.
5. Decide whether failed webhooks should be retried: up to 10 attempts after 5 minutes, 15 minutes, 1 hour, 2 hours, 4 hours and then every 24 hours.
6. Click Activate to finish.

Step 2 — Install the plugin in WordPress#

1. In WordPress, go to Plugins → Add Plugin.
2. Install the WooCommerce payment plugin for your FlowAlp Pay account — the integration panel in the dashboard links to the correct listing.
3. Click Install Now, then Activate.

Step 3 — Connect the plugin to your account#

Open WooCommerce → Settings and switch to the payment platform tab added by the plugin. Select the platform entry, enter your instance name — the subdomain of your payment page URL, so demo-shop for demo-shop.pay.flowalp.com — and start the connection. You are forwarded to the FlowAlp Pay login at https://login.pay.flowalp.com; after signing in, shop and account are linked automatically.

If your plugin version shows manual credential fields instead of the connection wizard, paste the instance name and the API key exactly as the integration panel in the dashboard displays them.

Step 4 — Enable and map payment methods#

1. Go to WooCommerce → Settings → Payments — each payment method appears as its own entry.
2. Enable or disable methods via the three-dots menu.
3. Click Manage on a method to set its title, description and — where offered — subscription support.
4. Save your changes.

A method appears at checkout only if it is also active on your FlowAlp Pay account and supports the shop currency. Typical Swiss line-ups include TWINT, Visa, Mastercard, American Express, PostFinance, Apple Pay, Google Pay, PayPal and Klarna — availability depends on your account configuration; see payment methods.

Step 5 — Run a test order#

1. Switch to TEST mode as described in Testing for developers.
2. Put a product in the cart and proceed to the checkout.
3. Select a payment method — WooCommerce redirects to the FlowAlp Pay payment page.
4. Pay with test cards or test credentials.
5. Verify the results: the browser returns to the shop confirmation page, the WooCommerce order changes status, the transaction shows up in the dashboard, and the webhook log records a 200 response.

Subscriptions and recurring payments#

To sell recurring products, install and activate the WooCommerce Subscriptions plugin. Two renewal models exist: with automatic renewal the stored payment method is charged when an instalment is due — only certain payment methods support this. With manual renewal the customer receives an email containing a payment link for each due instalment — this works with every payment method of your account. If you do not want recurring payments at all, disable the feature under WooCommerce → Settings → Subscriptions. Background on the billing side: subscriptions and recurring payments.

Refunds#

Execute full or partial refunds in the FlowAlp Pay dashboard. Once completed there, the refund is reported back to WooCommerce automatically and appears on the order.

Troubleshooting#

FAQ#

• Where do I find the instance name and API key? In the dashboard under API & Plugins, inside the WooCommerce integration panel — see also API credentials.
• Can I test without charging real money? Yes — use TEST mode with the test cards and run at least one successful and one failed payment.
• Does the plugin support multiple currencies? Yes. Each payment method must support the currency in use, though.
• Does the checkout stay inside my shop? The plugin uses the redirect flow to the hosted payment page; for embedded variants on custom pages see the checkout overview.
• A customer or subscription disappeared — did the payment plugin delete it? No. The plugin never modifies customer data in WooCommerce; look at the Subscriptions plugin or manual changes by WordPress users.