--- title: "WooCommerce Plugin" slug: "woocommerce-1" updated: 2025-10-28T11:57:50Z published: 2025-10-28T11:57:50Z canonical: "help.frisbii.com/woocommerce-1" --- > ## Documentation Index > Fetch the complete documentation index at: https://help.frisbii.com/llms.txt > Use this file to discover all available pages before exploring further. # WooCommerce Plugin ## Frisbii Pay Accept Visa, MasterCard, Dankort, MobilePay, American Express, Diners Club and more directly on your store with the Frisbii Pay Gateway for WooCommerce. The Frisbii Pay plugin extends WooCommerce allowing you to take payments on your store via Frisbii Pay’s API. **⤵️Download the plugin here:** [**Frisbii Pay – WordPress plugin**](https://wordpress.org/plugins/reepay-checkout-gateway/) --- ### Setup Guide The Frisbii Pay WooCommerce plugin allows merchants to integrate Frisbii Pay as a payment gateway in their WooCommerce store. This guide explains the settings available on the configuration page and how to properly configure them. #### **Installation** Before installing the Frisbii Pay plugin, ensure that WooCommerce is installed and activated. **Installation Steps** 1. Log in to your WordPress dashboard. 2. Navigate to **Plugins > Add New Plugin**. 3. Upload the [Frisbii Pay plugin ZIP file](https://wordpress.org/plugins/reepay-checkout-gateway/) or search for "Frisbii" as a keyword and install it from the plugin directory. 4. Activate the plugin. 5. Click on **Settings** to open the settings page. #### **Configuration Settings** The settings page can be found via **WooCommerce > Settings > Payment** - Click on **Manage**. ![](https://cdn.document360.io/b84e1b5d-2ba6-4465-8c62-fb45a2f31314/Images/Documentation/2025-09-25_11h20_42.png) To ensure that feedback from Frisbii payment processing reaches the module, you must configure a webhook in the Frisbii Pay Dashboard. - Log in to your Frisbii Dashboard. - Open **Configurations > Integration and tools > Webhooks**. - Ensure there is an active webhook that matches the **Webhook URL** on the configuration page of the module. **Enable/Disable Plugin** Enables or disables the Frisbii Pay gateway. **Title** Label that appears at this payment method in the checkout. **Default:** Frisbii Pay **Description** A caption text that appears when this payment method is selected. **Default:** Pay with all popular payment methods. ![](https://cdn.document360.io/b84e1b5d-2ba6-4465-8c62-fb45a2f31314/Images/Documentation/2025-09-25_11h20_37.png) --- #### API Keys **Test Private Key** Enter the private key from your **test** Frisbii account. To create a new key: - Make sure you are logged into your **test** account. - Open **Configurations > Integration and tools > API credentials**. - Click on "New" and create an API key. - Copy the key into the field. Test Account Information: - **Account:** Displays the name of the currently linked Frisbii account. - **State:** Indicates whether test mode is active on this account. - **Webhook:** Shows whether the webhook for **test** transactions is active. **Live Private Key** Enter the private key from your **live** Frisbii account. To create a new key: - Make sure you are logged into your **live** account. - Open **Configurations > Integration and tools > API credentials**. - Click on "New" and create an API key. - Copy the key into the field. Live Account Information: - **Account:** Displays the name of the currently linked Frisbii account. - **State:** Indicates whether live mode is active on this account. - **Webhook:** Shows whether the webhook for **live** transactions is active. --- #### Additional Configurations **Email address for notification about failed webhooks** Enter an e-mail address to receive notifications for failed webhooks. **Payment Window Display** Choose between a redirect window or an overlay window for the payment gateway. Available Options: - **Window:** Redirects customers to a new payment window. - **Overlay:** Displays an overlay payment window within the current page. > [!NOTE] > Note > > Some payment methods, such as Apple Pay, do not work with the overlay window. **Payment Methods** Select the payment methods that should be available with the Frisbii payment window. Ensure that they are enabled in the Frisbii Dashboard. **Instant Settle** Select which purchases should be instantly settled. Available Options: - **Online/Virtual Products:** Instantly settle for digital goods. - **Physical Products:** Instantly settle for tangible goods. - **Recurring (Subscription) Products:** Instantly settle subscription-based transactions. - **Fees:** Instantly settle any associated fees. **Language in Payment Window** Select the language to be used in the payment window. Options include Auto Detect (Default), English, Danish, Swedish, Norwegian, German, Spanish, French, Italian, Dutch. **Auto-settle** Determines whether orders are automatically settled when their status changes to completed. Check the box to disable auto-settlement. **Allow Credit Card Saving** Enable or disable customers saving their credit card details for future purchases. **Debug Mode** Enables logging for troubleshooting issues related to payments. **Show Meta Fields in Orders** Display meta fields related to Frisbii transactions in WooCommerce orders. **Show Meta Fields in Users** Display meta fields related to Frisbii user data in the WordPress user page. **Payment Logos** Choose the logos displayed in WooCommerce checkout for supported payment methods. Ensure the selected logos match the payment methods that are enabled in the Frisbii Dashboard. **Logo Height** Define the height of the payment logos displayed during checkout. **Default Value:** 24 pixels **Order Handle Failover** Generates a unique handle if an invoice with the current handle was settled previously. **Skip Order Lines** Determine whether each line of the order should be sent to Frisbii. **Order Auto-Cancel** Enable or disable automatic cancellation of orders. **Payment Button Text** The text displayed on the payment button for subscription purchases. **Default Value:** Register payment method #### **Sync Statuses** Synchronizes WooCommerce order statuses with Frisbii Pay invoice statuses. Check the box to enable two-way synchronization. **Status: Frisbii Pay Created** The WooCommerce status of a newly created order is **Pending payment.** **Status: Frisbii Pay Authorised** Select the status for WooCommerce orders after payment is authorised. Options include **Processing (default), On hold and Completed**. **Status: Frisbii Pay Settled** Select the status for WooCommerce orders after payment is settled. Options include **Processing, On hold and Completed (default).** **Order Column: Frisbii Status** Displays a column in WooCommerce orders grid showing the status of each order in Frisbii Pay. #### **Final Steps** - After configuring all settings, click **Save Changes**. - Test transactions using test mode before switching to live mode. - Monitor webhook activity to ensure smooth payment processing. --- ## Frisbii Billing Get all the advanced subscription features from Frisbii Billing while still keeping your usual WooCommerce tools. Frisbii Billing for WooCommerce plugin gives you the best prerequisites to succeed with your subscription business. **⤵️ Download the plugin here:** [**Frisbii Billing – WordPress plugin**](https://wordpress.org/plugins/reepay-subscriptions-for-woocommerce/#description) --- ### Setup Guide #### **Installation** Before installing the Frisbii Billing plugin, ensure the following: - WooCommerce is installed and activated. - The [Frisbii Pay plugin](/frisbii/docs/woocommerce-1#installation) is installed and configured. - A test or live API key is specified in the Frisbii Pay settings. #### **Installation Steps** 1. Log in to your WordPress dashboard. 2. Navigate to **Plugins > Add New Plugin**. 3. Upload the [Frisbii Billing plugin ZIP file](https://wordpress.org/plugins/reepay-subscriptions-for-woocommerce/) or search for "Frisbii" as a keyword and install it from the plugin directory. 4. Activate the plugin. 5. Click on **Settings** to open the settings page. #### **Settings Page** The settings page is found via **WooCommerce > Settings > Frisbii Billing** tab. #### **General Settings** - **Enable Logging:** Enables API logging for Frisbii Billing transactions. Logs can be viewed under **WooCommerce > Status > Logs**. - **Enable On Hold:** Allows users to put their subscriptions on hold via their account page. - **Compensation Method for On Hold:** Determines how billing is handled when a subscription is placed on hold. Options include No compensation, Full refund, Prorated refund, Full credit, and Prorated credit. - **Enable Cancel:** Allows users to cancel their subscriptions via their account page. - **Compensation Method for Cancel:** Determines how billing is handled when a subscription is canceled. Options include No compensation, Full refund, Prorated refund, Full credit, and Prorated credit. #### **Subscription Order Management** - **Subscription Order Default Status After Creation:** Sets the initial status for new subscription orders. Options include Pending Payment, Processing (default), On Hold, Completed, Cancelled, Refunded, Failed, and Draft. - **Renewal Order Default Status After Creation:** Sets the initial status for renewal orders. Options include Pending Payment, Processing (default), On Hold, Completed, Cancelled, Refunded, Failed and Draft. - **Enable Manual Subscription Start Date:** Allows administrators to set a manual start date for subscriptions. - **Manual Start Date Order Status:** Determines the order status that triggers the subscription renewals to start. Options include Pending Payment (default), Processing, On Hold, Completed, Cancelled, Refunded, Failed and Draft. #### **Email Notification Management** If configured, subscription-related emails can be sent from Frisbii instead of WooCommerce. This allows centralized email management in Frisbii. - **Disable Subscription Order Mails:** Disables email notifications from WooCommerce for new subscription orders. - **Disable Renewal Order Mails:** Disables email notifications from WooCommerce for subscription renewals. #### **Terms and Conditions** - **Enable Terms and Conditions:** Enables the Frisbii Billing terms and conditions checkbox. Customers must accept terms before completing a purchase. - **Page Terms and Conditions:** Select the page to link as Frisbii Billing Terms of Service. - **Checkout Terms and Conditions:** The text to display on the line next to the checkbox. Use the shortcode [frisbii_billing_terms] to display a link to the Terms of Service page. #### **Saving Changes** After configuring the settings, click **Save changes** to apply them. --- ## Creating Subscription Products ### Simple Subscription Products 1. Go to **Products > Add New** 2. In **Product Data**, select **Billing Simple Subscription** 3. Choose to either: - **Create new plan**: Set up a new subscription plan - **Choose existing plan**: Select from existing Frisbii plans ### Variable Subscription Products 1. Create product as above but select **Billing Variable Subscription** 2. Go to **Variations** section 3. For each variation, create or choose existing plans ### Adding Subscription Add-ons 1. In the product editor, click **Add-ons** section 2. Click **New add-on** 3. Either create new or choose existing add-ons 4. Configure pricing and options ### Subscription-Based Shipping 1. Go to **WooCommerce > Settings > Shipping** 2. Select a shipping zone > **Add flat rate shipping method** 3. In **Billing Add-on** section, create or choose existing add-on 4. Set shipping cost in the add-on amount field --- ## Discount and Coupon Management ### Creating Subscription Coupons 1. Go to **Marketing > Coupons** 2. Add new coupon 3. In **Discount type**, select **Billing** 4. Choose to: - **Create new coupon**: Set up new discount in Frisbii - **Use existing coupon**: Select existing Frisbii discount ### Discount Configuration When creating new discounts: - **Amount**: Set discount value - **Type**: Choose fixed amount or percentage - **Apply to**: Select what the discount applies to - **Duration**: Set how long discount lasts (e.g., Fixed Number = 3 for next 3 payments) --- ## Order and Subscription Management ### Viewing Orders **Parent Orders**: Initial subscription setup orders found under **WooCommerce > Orders** **Sub Orders**: Recurring payment orders (click **Show history** to view) **Frisbii Integration**: Use **See subscription** buttons to jump directly to Frisbii Admin for advanced management ### Payment Capture #### Full Capture 1. Go to **WooCommerce > Orders** 2. Select the order to capture 3. Click **Capture** button for full amount #### Partial Capture 1. In order details, hover over specific order line 2. Click the pencil icon that appears 3. Change the amount and click **Save** 4. Click **Capture** for the new amount #### Adding Order Lines Use **Add fee** or **Add product** to include additional items that need separate capture. ### Customer Self-Service Customers can manage their subscriptions under **My Account** when enabled: - **Add Payment Method**: Always available - **Put On Hold**: Can be enabled/disabled in Billing Settings - **Cancel Subscription**: Can be enabled/disabled in Billing Settings --- ## Troubleshooting ### Common Issues **Payments Not Processing**: - Verify API keys are correct and from the right environment (test vs live) - Check webhook configuration and IP whitelist - Enable debug mode for detailed logging **Webhook Failures**: - Configure email notifications for failed webhooks - Check security plugin settings - Verify webhook URL matches exactly **Subscription Issues**: - Ensure Frisbii Pay is configured before setting up Frisbii Billing - Verify same API keys are used in both plugins - Check plan mapping between WooCommerce products and Frisbii plans ### Debug Mode Enable debug mode in Frisbii Pay settings to: - Log all payment transactions - View detailed error messages - Monitor webhook communications Logs can be viewed under **WooCommerce > Status > Logs**.