WooCommerce NETbilling Payment Gateway

Accept payments from major credit cards on your WooCommerce website with NETbilling. This extension allows your customers to save their credit card and bank account to their WooCommerce account for fast and easy checkout. Includes full support for WooCommerce Subscriptions and Pre-Orders. You’re just moments away from getting the gateway setup and accepting payments! This document will show you how to setup and configure the extension.

Installation

↑ Back to top

1. Download the extension from your dashboard
2. Go to Plugins > Add New > Upload and select the ZIP file you just downloaded
3. Click Install Now, and then Activate
4. Go to WooCommerce > Settings > Payments and read the next section to learn how to setup and configure the plugin.

Setup and Configuration

↑ Back to top

Account Setup

↑ Back to top

First, you’ll need your NETbilling Account ID that was given to you when you signed up for NETbilling. If you don’t have this info, you’ll have to contact your account representative from NETbilling to get the information. Now log into your WooCommerce store and go to WooCommerce > Settings > Payments > NETbilling, then enter this value into the Account ID text box on the settings page:

You will also need to register the IP address of your server for authentication on the “Access Security” page of the NETbilling admin. A prerequisite to listing the server IP(s) is that you will need to enable/check “Enable Native Direct Mode v.3(SAS) Channel” from the same page. That’s it! You are now ready to start accepting credit cards and eChecks via NETbilling! If you want to tweak settings and customize the checkout process, keep reading.

Extension Settings:

↑ Back to top

• Enabled – This will enable the gateway to be used by customers to checkout.
• Title – This is the text shown for the payment during checkout and on the Order Received page.
• Description – This is the text shown under the title during checkout. Limited HTML is allowed. If you enable test mode, this section will also display a notice along with test credit card numbers.
• Card Verification (CSC) – Enable this to require customers to enter their CV2 (Card Security Code) when checking out. This can be useful if you have requirements in your NETbilling account for CV2 verification. This does not apply to saved cards or subscription renewals or renewals.
• Transaction Type – Select how transactions should be processed. “Charge” submits all transactions for settlement, while “Authorization” simply authorizes the order total for capture later.
• Charge Virtual-Only Orders – (Shown if Transaction Type is set to “Authorization”) Enable this to force charges on order containing only virtual items so they’re captured immediately instead of authorized (for example, to grant download access right away)
• Accepted Card Logos – This controls the card logos that display during checkout. This is purely cosmetic and has no affect on the cards actually accepted by your merchant account. Hold CTRL (CMD on Mac) to select multiple card types.
• Tokenization – Allows customers to securely save their payment details for future checkout. Please note that PCI storage must be enabled on your NETbilling account; see Step 6 of the Credit Card setup page.
• Account ID – This is the Account ID for your NETbilling account. Follow the steps above to get this.
• Site Tag – This can be configured from your NETbilling account and controls which email templates will be used. It also tags the site for accounting purposes if you are using the same merchant account across multiple sites.
• Debug Mode – Enable this is you are having issues correctly processing transactions. All debugging messages are cleaned of sensitive information before display, but as a best practice, please do not enable this unless you are having issues with the plugin.

Advanced Features

↑ Back to top

Capture Charges from WooCommerce Order Admin

↑ Back to top

This extension allows you to authorize charges during checkout, then manually capture them later. You can do this via your merchant account control panel, or can easily do so from the WooCommerce Edit Order page. You can read more about capturing charges with the plugin here.

Managing Payment Methods

↑ Back to top

Customers can manage their saved payment methods by going to their My Account page and scrolling to the “My Payment Methods” section. From here they can set any available saved payment method as active, or click the red X to delete the payment method. At this time, customers cannot add payment methods to their account from this page. They need to go through the normal checkout process in order to add a new payment method.

Enabling Tokenization

↑ Back to top

Login to your NETbilling Account and confirm under Setup > Credit Cards > Step 6 that repeat billing is enabled, and confirm with your account representative that this is enabled for your NETbilling account:

After you’ve confirmed this, enable “Tokenization” within the plugin settings.

eCheck Settings

↑ Back to top

• Enabled – This will enable the eCheck gateway to be used by customers to checkout. IMPORTANT – You must have eChecks enabled on your NETbilling account for this to function correctly. Follow the process below under “eCheck Issues” to get eChecks setup and enabled.
• Title – This is the text shown for the eCheck gateway during checkout and on the Order Received page. This defaults to “eCheck”.
• Description – This is the text shown under the title during checkout. Limited HTML is allowed. If you enable test mode, this section will also display a notice along with a test bank account number.
• Tokenization – Allows customers to securely save their payment details for future checkout. Please note that PCI storage must be enabled on your NETbilling account; see Step 6 of the Credit Card setup page.
• Share connection settings – Enabling this will allow you to use connection/authentication settings from credit card gateway. If this is disabled, you’ll have to enter a new NETbilling Account ID for eCheck transactions.
• Site Tag – This can be configured from your NETbilling account and controls which email templates will be used. It also tags the site for accounting purposes if you are using the same merchant account across multiple sites.
• Debug Mode – Enable this is you are having issues correctly processing transactions. All debugging messages are cleaned of sensitive information before display, but as a best practice, please do not enable this unless you are having issues with the plugin.

Troubleshooting

↑ Back to top

Having trouble? Follow these steps to make sure everything is setup correctly before posting a support request:

1. Check that your Account ID is correct.
2. Double-check that your Account ID is correct 😉
3. Enable debug mode to the checkout page and review the errors messages that NETbilling is providing.
4. Submit a support ticket, with the debug log as an attachment.

eCheck Issues

↑ Back to top

Make sure the ACH/eCheck type is enabled on your NETbilling account (Setup > Check Processing in your NETbilling account), or you might see errors. To get this setup, follow these steps:

1. Login to your NETbilling Account and go to Setup > Check Processing to apply for eCheck processing ($100 application fee applies).
2. Follow the application steps listed, including faxing your application to NETbilling.
3. Once your application is reviewed, your account number will automatically be entered into the system for check processing.

Other Information

↑ Back to top

WooCommerce Subscriptions/Pre-Orders Support

↑ Back to top

This gateway fully-supports all features of WooCommerce Subscriptions and WooCommerce Pre-Orders, with both credit cards and eChecks (if you have enabled eChecks). Please see the Recurring Billing section to ensure that your account has this capability enabled in order to process subscriptions. When Subscriptions is used, the enhanced “My Payment Methods” table is also active to prevent deleting cards associated with a subscription. You can read about subscription saved methods here.

Storing Credit Cards / eChecks

↑ Back to top

Credit card information is not stored on your server, rather it is tokenized and stored on NETbilling’s secure servers, which reduces your PCI compliance burden. The only data that’s saved on your site are tokens, which are placeholders for the card information (similar to poker chips). These allow your merchant account, and only your account, to run transactions for saved cards. You can manage customers’ saved payment method tokens on your site. You can read more about managing saved card tokens within your website here.

Trusted Static IP Addresses

↑ Back to top

NETbilling states that Trusted Static IP Addresses should be used in nearly all cases. However, if a connection from a dynamic or unknown IP address is required, the Dynamic IP Security Code can be configured on your NETbilling account’s Account Setup > Account Management > Access Security page. To send the Dynamic IP Security Code as part of the payment request please use the following code:

function wc_netbilling_request_parameters_dynip_sec_code( $parameters ) {

    /**
     * Replace value below with Dynamic IP Security Code generated under Account Setup > Account Management > Access Security in your NETbilling account
     */
    $parameters[ 'dynip_sec_code' ] = 'KAMewyfMma4yzfNZ';

    return $parameters;
}
add_filter( 'wc_netbilling_request_parameters', 'wc_netbilling_request_parameters_dynip_sec_code' );

Questions & Support

↑ Back to top

Already purchased and need some assistance? Get in touch with support via the help desk.