WDOnline – Invoice payment for woocommerce

WDOnline Invoice Payment for WooCommerce adds a flexible invoice payment method to WooCommerce. It is designed for B2B stores, wholesale customers, and other businesses that allow approved customers to place orders on account.

The plugin lets you control who can pay by invoice, assign payment terms and credit limits, prevent customers from exceeding their available credit, manage invoice information, and provide customers with a dedicated invoice overview in My Account.

Requirements

• WordPress 6.5 or later
• WooCommerce 8.0 or later
• PHP 7.4 or later
• A customer must have a WordPress user account and be logged in to use invoice payment

Guest customers cannot use invoice payment because the plugin needs a customer account to determine eligibility, payment terms, credit limits, and outstanding invoice balances.

Installation

1. Go to Plugins → Add New Plugin in WordPress.
2. Click Upload Plugin.
3. Select the plugin ZIP file.
4. Click Install Now.
5. Activate WDOnline Invoice Payment for WooCommerce.
6. Go to WD Online → WDOnline Invoice Payment for WooCommerce.

The plugin works independently and does not require a separate WD Online core plugin.

Administration tabs

The plugin administration page contains three tabs:

• Gateway – Configure the payment gateway, payment terms, credit controls, optional features, and role defaults.
• Invoice orders – View orders placed using invoice payment.
• User roles – Create and manage customer roles.

The User roles tab is available only to administrators.

Quick setup

For a basic setup:

1. Open the Gateway tab.
2. Enable Enable invoice payment.
3. Enter the default payment terms, for example 14 or 30 days.
4. Set a default credit limit, or enter 0 for unlimited credit.
5. Decide whether invoice payment should be enabled globally or only for selected user roles.
6. Review the settings under Role defaults.
7. Save the settings.
8. Edit individual customers if they need different terms, credit limits, or access rules.

Gateway settings

Enable invoice payment

This setting activates or deactivates the invoice payment gateway in checkout.

Disabling the gateway does not delete existing invoice orders, customer settings, uploaded invoice PDFs, balances, or invoice history.

Checkout title

The checkout title is the name displayed beside the payment method.

You can use the placeholder to display the customer's resolved payment term. For example:

Invoice – days

For a customer with 30-day terms, the title will be displayed as Invoice – 30 days.

Checkout description

The checkout description is shown when the customer selects invoice payment. The placeholder can also be used here.

Order instructions

Order instructions are displayed after checkout and in relevant customer order emails. Use to include the payment term assigned to the order.

Order status after checkout

Choose the WooCommerce order status assigned after an order is placed using invoice payment:

• Processing
• On hold
• Pending payment

The WooCommerce order status and the plugin's invoice status are separate. An order can therefore be processing while its invoice is not yet created or remains unpaid.

Virtual orders

Enable this option if customers should be allowed to use invoice payment for orders containing only virtual products.

Global defaults

Global defaults apply when no individual customer setting or role-specific setting overrides them.

Default eligibility

Enable this option to allow invoice payment for logged-in customers by default.

If this option is disabled, invoice payment can still be enabled for selected user roles or individual customers.

Default payment terms

Enter the default number of days customers have to pay from the invoice date.

Payment terms are calculated from the invoice date, not the order date. If an order is placed on September 1, invoiced on September 5, and has 30-day terms, the due date will be October 5.

Credit control

Default credit limit

The credit limit is the maximum total invoice exposure allowed for a customer.

• Enter a positive amount to set a limit.
• Enter 0 for unlimited credit.

The plugin calculates available credit as:

Credit limit − open invoice balance = available credit

Open invoice exposure includes unpaid orders placed with WDOnline Invoice Payment, including orders that have not yet received an invoice number or invoice date. This prevents a customer from placing several orders that collectively exceed the credit limit before the first invoice is issued.

Cancelled, failed, refunded, and paid invoice orders are excluded as appropriate.

Checkout credit-limit message

This message is displayed when invoice payment becomes unavailable because the new order would exceed the customer's available credit.

The following placeholders are available:

• – The customer's resolved credit limit
• – The remaining credit after open invoice orders
• – The current checkout total

Overdue invoices

Enable Block invoice payment when the customer has overdue invoice orders to prevent customers with overdue invoices from placing new orders using invoice payment.

Overdue grace period

The grace period adds a number of days after the invoice due date before the invoice is treated as overdue.

For example, an invoice due on October 1 with a three-day grace period becomes overdue after October 4.

Optional features

The Features section lets you choose which administrative and customer-facing parts of the plugin are active.

Disabling a feature hides its interface but does not delete saved invoice information, customer settings, order history, balances, or uploaded documents.

Customer profile – Invoice payments

Shows invoice access, payment terms, credit controls, and invoice balance information when editing a WordPress user. It also adds invoice information to the Users list.

Orders – Invoice status

Adds invoice due information and invoice-status filtering to the WooCommerce order list.

Order – Invoice management

Adds the Invoice payment panel to individual WooCommerce orders. This panel is used to manage invoice numbers, dates, statuses, payment dates, and PDF documents.

Dashboard – Invoice Payment Overview

Adds an invoice overview widget to the main WordPress Dashboard for users who can manage WooCommerce.

Customer account – Invoice balance and history

Adds the Invoice payments section to the customer's WooCommerce My Account area. It can display payment terms, balances, invoice history, statuses, due dates, and protected PDF downloads.

The following settings depend on this feature and cannot be enabled unless it is active:

• Customer account – Credit limit – Shows or hides the customer's total credit limit.
• Customer account – Available invoice credit – Shows or hides the customer's remaining available invoice credit.

Hiding these values does not disable credit control. The plugin will continue enforcing the customer's credit limit in checkout.

My Account menu label

Enter the text used for the menu item in the customer's account area. This changes only the visible label and does not change the endpoint URL.

My Account page heading

Enter the heading displayed at the top of the customer's invoice page.

Orders – External invoice PDFs

Enables secure PDF invoice uploads on invoice orders. Customers can download their invoice PDFs from their account after logging in.

Role defaults

Role defaults let you assign different invoice conditions to different WordPress or WooCommerce user roles.

For each role, you can configure:

• Invoice payment access
• Payment terms
• Credit limit
• Overdue invoice handling

Available choices include using the global default, enabling or disabling invoice payment, entering role-specific payment terms, assigning a role-specific credit limit, and allowing or blocking invoice payment when overdue invoices exist.

The setting priority is:

1. Individual customer settings
2. User-role settings
3. Global defaults

For example, a global payment term may be 14 days, while wholesale customers receive 30 days and one specific customer receives 60 days.

Creating customer roles

Open the User roles tab to create a new role.

1. Enter a role name.
2. Enter an optional technical role slug. If left blank, the plugin generates one from the role name.
3. Select an existing role whose permissions should be copied.
4. For normal B2B customer accounts, copying the WooCommerce Customer role is recommended.
5. Create the role.

The new role will automatically appear under Role defaults.

The User roles tab also shows all existing roles, their technical slugs, origins, and the number of assigned users.

Only roles created through this plugin can be deleted from this page. A role cannot be deleted while it is assigned to one or more users. WordPress, WooCommerce, and third-party roles are protected.

Individual customer settings

Individual settings override role defaults and global defaults.

To configure a customer:

1. Go to Users in WordPress.
2. Edit the relevant customer.
3. Locate the Invoice payment section.
4. Configure the required fields.
5. Update the user.

Invoice payment access

Choose whether the customer should inherit the role or global setting, be explicitly enabled, or be explicitly disabled.

Payment terms

Enter the customer's payment term in days. Leave the field empty to inherit the role or global default.

Credit limit

Enter the customer's credit limit. Leave the field empty to inherit the role or global default, or enter 0 for unlimited credit.

Overdue invoice handling

Choose whether the customer should inherit the default policy, be blocked when overdue invoices exist, or remain allowed to use invoice payment despite overdue invoices.

The customer profile also displays the resolved payment terms, open invoice balance, available credit, and overdue balance when the relevant administration feature is enabled.

Checkout behaviour

Invoice payment is shown only when all relevant conditions are met. The customer must:

• Be logged in
• Be eligible for invoice payment
• Have sufficient available credit, unless credit is unlimited
• Meet the overdue-invoice rules
• Meet the virtual-order setting when the order contains only virtual products

If a credit limit is exceeded, invoice payment is removed and the configured credit message is shown. The message updates when the checkout total changes.

The plugin validates the credit rules again when the order is submitted. This server-side validation prevents checkout from being completed with invoice payment if the account no longer meets the rules.

Managing invoice orders

Orders placed using invoice payment contain an Invoice payment panel in the WooCommerce order editor.

Payment terms

The customer's resolved payment terms are saved on the order at checkout. Later changes to the customer's account do not alter existing orders.

Invoice number

Enter the invoice number generated by your accounting or invoicing system.

Invoice date

Enter the date the invoice was issued. The due date is calculated from this date and the payment terms saved on the order.

Due date

The due date is calculated automatically. It is not calculated until an invoice date has been entered or the order has been marked as invoiced.

Invoice status

The invoice status is managed independently from the normal WooCommerce order status. Depending on the available information and actions, an invoice can be shown as:

• Not invoiced
• Invoiced
• Paid
• Overdue

Use the order-panel buttons to mark an invoice as invoiced, paid, or unpaid.

Uploading an external PDF invoice

The plugin does not generate invoices. If you create invoices in an external accounting system, you can upload the completed PDF to the corresponding WooCommerce order.

1. Open the order.
2. Locate Invoice PDF in the Invoice payment panel.
3. Select a PDF file.
4. Click Upload PDF or Replace PDF.
5. Update the order if required.

The original PDF filename is displayed above View current PDF in the order editor.

PDF files are stored privately under randomized internal filenames. They are not added to the public WordPress Media Library and are not exposed through a public media URL.

Downloads are handled through WordPress and require authorization. Access is limited to authorized administrators and the customer who owns the order.

The maximum PDF file size is 10 MB.

Invoice orders overview

Open the Invoice orders tab to view orders placed using WDOnline Invoice Payment.

The overview includes:

• Order number
• Order date
• Customer
• WooCommerce order status
• Invoice status
• Due date
• Order total

Use the order-status filter to narrow the list. Click an order number to open the WooCommerce order editor.

Customer My Account area

When the customer-account feature is enabled, eligible customers and customers with previous invoice orders receive an Invoice payments menu item in My Account.

Depending on your display settings, the page can show:

• Current payment terms
• Open invoice balance
• Credit limit
• Available invoice credit
• Overdue balance
• Invoice order history
• Invoice number
• Invoice date
• Due date
• Invoice status
• Order total
• Secure PDF invoice download

Customers can continue to view historical invoice orders even if invoice payment is later disabled for new orders on their account.

Invoice Payment Overview dashboard

The WordPress Dashboard widget gives store managers a quick overview of invoice-payment activity.

Available information includes:

• Invoice sales
• Number of invoice orders
• Number of invoice customers
• Average invoice order value
• Paid invoices
• Average payment time
• Outstanding invoice balance
• Overdue balance
• Invoices due within the next seven days
• Largest invoice customer
• Top five invoice customers
• Outstanding-balance development when enough historical data is available

Statistics can be filtered by predefined periods or a custom date range. The widget uses cached calculations for performance and can be refreshed manually.

Emails and order details

The plugin can display invoice instructions, payment terms, invoice dates, due dates, and invoice status in relevant WooCommerce customer emails and order details.

Because payment terms are saved on the order, the information remains consistent even if the customer's current account settings change later.

Translation

All standard plugin text is written in English and uses the WordPress translation system.

The plugin includes a POT template and is compatible with:

• WordPress language packs
• Loco Translate
• Standard PO and MO translation workflows

Custom checkout titles, descriptions, instructions, account labels, headings, and credit-limit messages can also be edited directly in the plugin settings.

WooCommerce compatibility

The plugin supports:

• Classic WooCommerce checkout
• WooCommerce Checkout Blocks
• WooCommerce High-Performance Order Storage (HPOS)
• Legacy WooCommerce order storage

Optional support diagnostics

The plugin can integrate with WD Online Support Diagnostics when that separate plugin is installed.

The diagnostics integration is optional. WDOnline Invoice Payment continues to work normally when the diagnostics plugin is not installed or is deactivated.

Diagnostic checks can help identify configuration problems without automatically sending telemetry or customer information to external services.

Troubleshooting

Invoice payment is not visible in checkout

Check the following:

1. The gateway is enabled.
2. The customer is logged in.
3. The customer, role, or global defaults allow invoice payment.
4. The order does not exceed the available credit.
5. The customer is not blocked by an overdue invoice.
6. Virtual orders are allowed if the cart contains only virtual products.

Individual customer settings take priority over role and global settings, so always check the customer's user profile when the result is unexpected.

The customer's available credit appears incorrect

Review the customer's open invoice orders. Unpaid invoice-payment orders count toward credit exposure even if they have not yet been assigned an invoice date or invoice number.

Also check whether an invoice has been marked as paid and whether refunds or cancellations have been recorded correctly in WooCommerce.

The due date is not displayed

A due date is calculated only after an invoice date has been entered or the order has been marked as invoiced.

The Invoice payments account link returns a 404 page

Update to the latest plugin version. If the problem remains, go to Settings → Permalinks in WordPress and click Save Changes once to rebuild the rewrite rules.

A PDF cannot be uploaded

Confirm that:

• The selected file is a valid PDF
• The file is no larger than 10 MB
• The WordPress uploads directory is writable
• The external invoice PDF feature is enabled

A user role cannot be deleted

Only roles created through this plugin can be deleted from the User roles tab. Move all users to another role before deleting a plugin-created role.

Recommended configuration workflow

For most B2B stores, the following approach provides clear control:

1. Keep global invoice eligibility disabled.
2. Create or select one or more approved B2B customer roles.
3. Enable invoice payment and set standard terms for those roles.
4. Assign approved customers to the appropriate role.
5. Use individual customer settings only for exceptions.
6. Set realistic credit limits and enable overdue blocking where appropriate.
7. Review invoice orders and outstanding balances regularly.

This setup ensures that invoice payment is available only to approved customers while still allowing individual agreements when needed.