CentroBill Payment Gateway for WooCommerce

The CentroBill plugin extends WooCommerce and allow you to take payments directly on your store using CentroBill’s API.
Plugin also supports the WooCommerce Subscriptions extension.

Please go to the site centrobill.com to create a merchant account and start receiving payments.

Personal CentroBill API Token and Merchant Portal login credentials

• Obtain your personal account’s Token from your CentroBill account manager.
• Obtain CentroBill Merchant Portal login credentials from your CentroBill account manager.

Setup your account in the CentroBill Merchant Portal

• Log in to your CentroBill Merchant Portal using login credentials provided by your CentroBill account manager.
• Navigate to Sites&Products sections by selecting the tab in the upper menu.
• Click blue Create Site button.
• Input the name of your site into the Name of site field.
• In the Site type choose Woocommerce website.
• Add your website URL to the WordPress URL field. All the following links will be auto-populated (Success URL, Decline URL and IPN URL) and can be changed if you will need it.
• Below on this page, in the Colors menu you can also modify style of the payment page if you want it to be styled to your website.
• Tracking code field is meant for GA pixel or for conversion pixels of other analytical platforms. So, if you want to track sales, you can paste the conversion pixel to this field.
• After you feel you everything is correct and ready click blue Create site button at the bottom.

Verification

• Contact your CentroBill account manager to verify your setup.
• Please, send the IP address(‘s) of your server, which will send calls to CentroBill payment feed to your CentroBill account manager.

Verify that you are running the latest version of WordPress and WooCommerce.
Plugin requires at least WordPress 5.1 & WooCommerce 3.5, and has been tested to work with versions up to: WP 6.1 & WooCommerce 7.0.1.

Automatic installation

• Download plugin repository as a single zip file.
• Log into your WordPress as admin, click on Plugins section in the menu, click Add new.
• Click Upload Plugin, click Choose File to select the zip file from your computer or just type this plugin’s name.
• Install the plugin and activate it.
• Navigate to plugin settings and fill settings.

Manual installation

• Unpack and upload the plugin folder to the /wp-content/plugins/ directory.
• Activate the plugin through the Plugins menu in WordPress.
• Navigate to plugin settings and configure.

Updating

Automatic updates should work like a charm.
As always though, ensure you backup your site just in case.

Plugin configuration

To configure the CentroBill Payment Gateway plugin correctly, please follow the steps below:

• Go to WooCommerce menu > Settings and click on Payments menu tab.
• In Payments menu tab click on Centrobill and make sure Enable/Disable option is checked.
• Locate Authentication key input form field on a page and paste your API auth key into it.
• Locate Site ID input form field on a page and paste your CentroBill’s site ID into it.
• Save changes.

If you don’t have your Personal CentroBill API Auth Key, please contact your CentroBill account manager.

1. 

   Range of payment methods such as credit cards and alternative payment methods.

2. 

   The plugin settings screen used to configure the Centrobill payment gateway.

3. 

   Change the title and description for every payment gateway.

4. 

   Pay with a credit card.

5. 

   Pay with an alternative payment method.

6. 

   Tax. General options.

7. 

   Tax options.

8. 

   Tax. Product data.

2.2.11 – 2025-09-22

• Add – New address field in consumer data, combining billing_address_1 and billing_address_2.

2.2.10 – 2025-08-11

• Add – Configurable base URL for the payment page (plugin settings)

2.2.9 – 2025-07-18

• Add – New endpoint to retrieve payment methods (get-payment-details)
• Update – Include billing country and product price in payment method requests to improve payment method retrieval

2.2.8 – 2025-04-10

• Add – Support for paid trials (sign-up fee)
• Update – Include available payment methods in the request for generating the payment page URL
• Update – Use hash for generating external user ID based on site ID and user ID or email

2.2.7 – 2024-07-05

• Update – wc_centrobill_get_useragent and wc_centrobill_get_browser_accept_header functions explicitly return strings.
• Fix – Remove userAgent and browserAcceptHeader from default consumer data preparation in WC_Centrobill_Api::prepareConsumerData and add them conditionally.

See changelog for all versions