WooCommerce

This guide will walk you through the installation, configuration, and use of the CentralPay plugin for WooCommerce (WordPress).

ℹ️ The CentralPay platform supports various payment methods (credit/debit cards, Bank transfers, SEPA Direct Debits, and Payment Initiation Service (PIS)) and payment options (one-time payments, subscriptions, installment plans, etc.). This plugin only allowsfor the processing of one-time credit/debit card transactions.   

If you'd like to request a change to the plugin, please visit https://support.centralpay.com: Support & Settings > Suggest a new feature.

1. Download the plugin

• For WooCommerce ➝ Download the CentralPay plugin ZIP archive

⚠️ Be sure not to unzip it manually.

2. Installation on WordPress

1. Log in to your WordPress admin dashboard
2. Go to Extensions > Add
3. Click ” Upload an Extension“
4. Select the file ” centralpay220.zip ” and click ” Install Now“
5. Once the installation is complete, click ” Enable Extension“

3. Module Configuration

1. Go to WooCommerce > Settings > Payments
2. Click on CentralPay to access the settings
3. Fill in the following fields, then click ” Save Changes “:

Field	Description	Access to Data
Merchant ID	This is your Merchant Public Key. Do not confuse it with the Merchant UUID.	CentralPay Merchant Portal > Administration > Technical Support > Copy “Merchant Public Key”
API Login	Your CentralPay API user ID	CentralPay Merchant Portal > Administration > Technical Support > Click on your “API ID” > Copy the “login”
API Password	Your CentralPay API user password	CentralPay Merchant Portal > Administration > Technique > Click on your “API ID” > Edit > Generate a password > Copy the password > Click “Update”
POS ID	Unique identifier for your Point of Sale (POS) (UUID)	CentralPay Merchant Portal > Configuration > Points of Sale > Copy the ID of the relevant Point of Sale (POS)
Test / Production Mode	Enable test mode if you want to use the sandbox environment (the login and password must be those for your CentralPay test Merchant Profile).	/
Redirect URL	Redirects your customers to a custom page after they complete payment through our form.	Enter the URL of your payment confirmation page.

4. Order Status

The CentralPay WooCommerce plugin automatically includes a redirect URL (return_url) in the payment form link. This URL redirects the customer to the order confirmation page (/checkout/order-received/) and updates the order status based on the payment result.

If the end customer closes the payment window before being redirected, the order update may not trigger correctly on the WooCommerce side.

To ensure that order status is updated reliably, we recommend setting up a hook (server-to-server callback) in your CentralPay Backoffice.

Setup steps:

1. Go to:
   Production: https://backoffice.centralpay.net/admin/hook/
   Testing: https://test-backoffice.centralpay.net/admin/hook/
2. Create a hook with the following parameters:
   • Event: Point of Sale (POS) > TRANSACTION_SUCCEDEED
   • Assigned to a Point of Sale (POS): Select your WooCommerce POS store
   • URL: https://votre-site-woocommerce.com/?wc-api=cpay_validation
     (Replace with the URL of your WooCommerce site.)
3. Save the Hook

The ` /?wc-api=cpay_validation ` parameter is required for the CentralPay WooCommerce plugin to recognize the notification and trigger the order status update.

This configuration must be set up both in your Test environment and on your production Merchant Profile.

5. Logo Customization

You can also customize the payment interface by adding your website’s logo through the Backoffice:

1. Go to: https://backoffice.centralpay.net/admin/point_of_sale/
2. In your Point of Sale details, click Edit
3. Upload your logo in the ” Logo” section

This logo will be displayed directly in the payment form to provide a more consistent user experience.

6. Test Mode

• Enable test mode in the settings (please note: you must have a CentralPay test Merchant Profile and enter the credentials for that test Merchant Profile)
• Use the test cards provided by CentralPay to simulate payments
• Check that it is working properly:
  • From the payment form
  • Redirects
  • Order Statuses

7. Payment Tracking

• View all your payments in WooCommerce > Orders
• The CentralPay plugin automatically updates order statuses
• If needed, an event log is available in the plugin’s ` error.log ` file

8. Available Languages

The plugin is available in:

• 🇫🇷 French
• 🇬🇧 English

You can edit or add your own translations using the ` .po ` files located in the ` /languages` folder, or by using a plugin such as Loco Translate.

9. Uninstallation

To uninstall the plugin:

• Disable it through the Extensions menu
• Click ” Delete“
• The uninstall script will delete the plugin’s settings

10. Support

If you have any questions or need assistance, please contact our technical support team at https://support.centralpay.com.
Please include your Merchant ID, your website URL, and as many details as possible about your request.