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
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
Log in to your WordPress dashboard.
Navigate to Plugins > Add New Plugin.
Upload the Frisbii Pay plugin ZIP file or search for "Frisbii" as a keyword and install it from the plugin directory.
Activate the plugin.
Click on Settings to open the settings page.
Configuration Settings
The settings page can be found via WooCommerce > Settings > Payment
Click on Manage.
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.
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
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.
Setup Guide
Installation
Before installing the Frisbii Billing plugin, ensure the following:
WooCommerce is installed and activated.
The Frisbii Pay plugin is installed and configured.
A test or live API key is specified in the Frisbii Pay settings.
Installation Steps
Log in to your WordPress dashboard.
Navigate to Plugins > Add New Plugin.
Upload the Frisbii Billing plugin ZIP file or search for "Frisbii" as a keyword and install it from the plugin directory.
Activate the plugin.
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
Go to Products > Add New
In Product Data, select Billing Simple Subscription
Choose to either:
Create new plan: Set up a new subscription plan
Choose existing plan: Select from existing Frisbii plans
Variable Subscription Products
Create product as above but select Billing Variable Subscription
Go to Variations section
For each variation, create or choose existing plans
Adding Subscription Add-ons
In the product editor, click Add-ons section
Click New add-on
Either create new or choose existing add-ons
Configure pricing and options
Subscription-Based Shipping
Go to WooCommerce > Settings > Shipping
Select a shipping zone > Add flat rate shipping method
In Billing Add-on section, create or choose existing add-on
Set shipping cost in the add-on amount field
Discount and Coupon Management
Creating Subscription Coupons
Go to Marketing > Coupons
Add new coupon
In Discount type, select Billing
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
Go to WooCommerce > Orders
Select the order to capture
Click Capture button for full amount
Partial Capture
In order details, hover over specific order line
Click the pencil icon that appears
Change the amount and click Save
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.