Skip to content

WooCommerce

Accept payments with Finix on your WooCommerce Store

Finix for Woocommerce

Finix for WooCommerce overview

The Finix plugin for WooCommerce lets you accept payments and manage orders directly from your WordPress admin.

  • Payment methods: Credit and debit cards, Apple Pay, Google Pay, and bank transfers (ACH).
  • Pricing: Interchange-plus pricing with itemized fee breakdowns.
  • Blocks checkout: Compatible with WooCommerce's block-based checkout and the classic checkout flow.
  • Dispute and bank return handling: Order statuses update automatically via webhooks when disputes or bank returns occur.
  • Sandbox environment: Test your integration before going live.

Download

Finix for WooCommerce is available for download at wordpress.org.

Finix requirements

  • Finix Sandbox Account to process Sandbox transactions. You will not be able to move real money in this environment.
  • Finix Live Account to run card or ACH transactions.

Apple Pay requirements

Apple Pay requires domain verification, which involves hosting a file in the /.well-known/ directory of your site. Whether this is supported depends on your WordPress hosting plan.

PlatformCan Host Verification File?Notes
WordPress.org (self-hosted)YesFull server access to place files in /.well-known/
WordPress.com Business/Commerce planYesAllows plugins and some server-level access
WordPress.com Free/Personal/PremiumNoNo access to server file system; cannot place arbitrary files at custom paths

Before you begin

Keep your existing payment gateway enabled while you install and configure Finix. After you have configured and verified Finix in Production, disable the old gateway if you do not want to present multiple payment options.

To disable an existing payment gateway:

  1. In your WordPress admin, go to WooCommerce → Settings → Payments.
  2. Find the gateway you want to remove and toggle it off.

Installation

The steps below are split into two tabs - Sandbox and Production. If you want to test your setup before going live, start with Sandbox. Once you are approved and ready to accept real payments, follow the Production tab.

  • Sandbox: A test environment where no real money is moved. Use this to verify your integration before launch.
  • Production: Your live environment that processes real transactions with real customers.

Step 1. Download Finix for WooCommerce plugin

Download Finix for WooCommerce

Accept Card and Bank Payments with WooCommerce.

Step 2. Install Finix for WooCommerce plugin

Add new plugin
  1. In your WordPress admin, click Plugins → Add New Plugin.
  2. Click Upload Plugin.
  3. Click Choose File, select the downloaded plugin file, and click Install Now.
  4. Click Activate Plugin.

Step 3. Configure for your environment

Step 3a. Sign up for a Finix Sandbox account

To create a Sandbox account, read our guide or sign up directly.

We recommend choosing Direct Merchant as your Customer Type.

Step 3b. Open the Finix plugin settings and select Sandbox

WooCommerce Payments settings
  1. In your WordPress admin, go to WooCommerce → Settings.
  2. Click the Payments tab.
  3. Find Finix Gateway in the list and click Manage.
  4. Locate the Environment dropdown and select Sandbox.

Step 3c. Configure your webhook

A webhook is an automated notification that Finix sends to your WooCommerce store when an event occurs - for example, when a payment is processed or a dispute is opened. Setting up a webhook keeps your order statuses in sync automatically.

Part 1: Get webhook details from the plugin
Webhook configuration

In the Finix plugin settings, scroll down to the webhook section. Note the Webhook URL, Username, and Password - you will need these in the next step.

Part 2: Create a webhook in the Finix Dashboard
  1. Log in to your Finix Dashboard.
  2. Select the Sandbox environment from the environment selector. Finix automatically selects your environment if you only have access to one.
  3. Click Developer in the left menu.
  4. Click the Webhooks tab.
  5. Click Create Webhook.
  6. Enter the URL, Username, and Password from Part 1. Set Authentication Type to Basic. Add a nickname to identify this webhook later.
  7. Go to Events and select Only the following entities and types.
  8. Check Transfer and Disputes for both created and updated, then save the webhook.

Step 3d: Enter your Sandbox credentials

API keys are unique credentials that let the Finix plugin securely communicate with Finix on your behalf.

In the Finix Dashboard, go to the Developer page. You will find:

  • Application ID: starts with AP
  • Merchant ID: starts with MU

Enter both values in the Finix plugin settings.

To generate API keys:

  1. On the Developer page, click Create API Key.
  2. Copy the Username and Password and enter them in the Finix plugin settings.

Step 3e. Enable payment methods

With your credentials saved, enable the Finix Gateway. Your customers will now see Finix as a payment option at checkout.

Credit card payment is enabled by default. Apple Pay, Google Pay, and bank transfer are available but disabled. You can enable them in their respective tabs within the plugin settings if you want to offer them.

Because WooCommerce already collects billing and shipping information during checkout, your customers will not be asked to re-enter their billing details in the Finix payment form.

Set up Apple Pay

Step 1. Enable Apple Pay in WooCommerce

  1. Navigate to the Apple Pay tab in the Finix plugin settings.
  2. Select Enable Apple Pay Gateway.
  3. Customize your Apple Pay button style and type to match your storefront.
Add Web Domain modal with the verification file download

Step 2. Register your domain

Before you can accept Apple Pay, verify and register your domain with Apple. You complete this step in the Finix Dashboard. After you register the domain, download the verification file and host it on your website.

To register your domain:

  1. Log in to your Finix Dashboard and click Developer.
  2. Click the Alt Payment Methods tab.
  3. Click Add Web Domain and follow the instructions to host the verification file.
Add Web Domain modal with the verification file download
Do not close the modal until you have hosted the verification file

Do not click Submit on step 3 in the modal until you have uploaded the verification file that Finix generates in the steps below.

  1. Enter a domain name.
Add Web Domain modal with the verification file download
  1. Download the verification file.
Add Web Domain modal with the verification file download
  1. Host the verification file at /.well-known/apple-developer-merchantid-domain-association.
Add Web Domain modal with the verification file download

Set up Google Pay

Step 1. Enable Google Pay in WooCommerce

  1. Navigate to the Google Pay tab in the Finix plugin settings.
  2. Select Enable Google Pay Gateway.
  3. Customize your Google Pay button style and type to match your storefront.
Add Web Domain modal with the verification file download

Step 2. Register with Google Business Console

To accept Google Pay, you need a Google Merchant ID from the Google Pay & Wallet Console.

  1. Sign in to the Google Pay & Wallet Console.
  2. Complete the business profile and agree to the Google Pay API Terms of Service.
  3. Once approved, copy your Google Merchant ID.
  4. Enter your Google Merchant ID in the Finix plugin settings.

Searching for transactions on the Finix Dashboard

Filter by Order ID

You can find Payments using WooCommerce Order Ids on the Finix Dashboard.

  1. Navigate to the Payments list page.
  2. Click on the Filters.
  3. Under Tags, enter WooCommerce Order Id.
  4. Click Apply.