WooCommerce Ogone Payment Gateway

Overview ↑ Back to top

Accept credit card payments on your WooCommerce shop with Ogone. Payment transactions take place on Ogone’s secure servers, meaning your site never handles sensitive credit card data, and your customer’s payment information is secure. This document will show you how to setup and configure the extension to work with your Ogone account.

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 > Checkout and read the next section to learn how to setup and configure the plugin.

Setup and Configuration ↑ Back to top

Setup ↑ Back to top

To configure the plugin to accept payments, you’ll first need to log into and configure your Ogone account. Note that there are two back offices, one that you log into with a test account, and the other that you log into with a live account:

After logging in, follow these steps:

  1. Go to Configuration > Technical Information > Global Security Parameters and set the Hash algorithm to SHA-256. Then scroll to the bottom of the page and hit “Save”. woocommerce-ogone-backoffice-hash
  2. Go to Configuration > Technical Information > Data and Origin Verification and enter the base URL of your WooCommerce site, i.e. http://www.example.com (if your site uses SSL on the checkout page then don’t forget to include HTTPS in the url: https://www.example.com). On that same page, enter a SHA-IN pass phrase of your choosing. Then scroll to the bottom of the page and hit “Save”. woocommerce-ogone-backoffice-origin-verification
  3. Go to Configuration > Technical Information > Transaction Feedback and ensure the box is checked “I would like to receive transaction feedback parameters on the redirection URLs.”: woocommerce-ogone-backoffice-transaction-feedback
  4. Under Direct HTTP server-to-server request, ensure that “Timing of the request” setting is set to “No request”:
    WooCommerce Ogone setup 4
  5. Further down on that same page (Transaction Feedback) and under “Dynamic e-Commerce parameters” ensure that COMPLUS, NCERROR, ORDERID, PAYID, and STATUS are listed in the “Selected” box: woocommerce-ogone-selected-parameters
    Note to existing customers: if you previously purchased the Ogone plugin and did not configure the COMPLUS setting, you may see a notice in your WooCommerce admin instructing you to configure this setting within Ogone and then click “complete” on the message. It’s important that you perform both steps so as to avoid interruptions in your ability to process credit cards.
    • Optional Step: You can optionally select the parameters CARDNO, BRAND, and ED to display the last four digits of the credit card account number, the card brand, and the expiration date in the WooCommerce admin order notes.
  6. Scroll a bit further down this same page (Transaction Feedback) and set a SHA-OUT pass phrase of your choosing. Finally scroll to the bottom of the page and hit “Save”. woocommerce-ogone-backoffice-sha-out

Note that if you wish to run test transactions you’ll have to follow the above steps twice: first for your test account, and then again for your live account when you’re ready to accept customer payments.

Extension Settings ↑ Back to top

Once your Ogone back office settings are complete, you’ll need to log into your WooCommerce admin and configure the WooCommerce Ogone plugin.

WooCommerce Ogone Admin Settings
Ogone Admin Settings
  • Enable/Disable – This will enable the gateway to be used by customers to checkout.
  • Testing – Set to “Yes” to use with a test account. Set to “No” when you’re ready to start accepting live payments.
  • 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.
  • Ogone PSPID – The PSPID for your account, provided by Ogone. Note that you should have a different PSPID for testing mode vs. live mode.
  • Ogone SHA-IN – This is the SHA-IN passcode you created while configuring your Ogone account in step 2 above.
  • Ogone SHA-OUT – This is the SHA-OUT passcode you created while configuring your Ogone account in step 6 above.
  • Template Page – Optional URL (full, not relative — ex: http://mysite.com/wp-content/themes/my-theme/templatepage.html) to a template page that can be used to customize the payment form (here’s Ogone’s documentation). The URL must be on the same server as your site.
  • 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. Verify that your PSPID is for a test account if Testing is enabled, or otherwise is for a live account.
  2. Verify that the Dynamic e-Commerce parameters are correctly configured in your Ogone back office, as described in step 5 above.
  3. Verify that SHA-IN and SHA-OUT configured in your Ogone account are copied exactly into the plugin settings.
  4. Enable debug mode to the checkout page and review the transaction requests/responses for errors as per the instructions below:

Step 1: Ogone error logs – Log into your Ogone back office and go to Configuration > Error Logs to view any transaction errors logged by Ogone:


Step 2: Review error codes by checking for the following errors:

  • If you get an error that says “unknown order/1/r“, this means that the “Data and origin verification” tab, “Checks for e-Commerce” section of the Technical Information page is misconfigured. The referrer detected by the plugin is not a URL the merchant has entered in the URL field. This page is most likely displayed after clicking “Place Order”:

    WooCommerce Ogone Error notice 1

    Solution: Check your URL setting as described in step 2 above.

  • You will get the “unknown order/1/s” error message if the “Data and origin verification” tab, “Checks for e-Commerce” section of the Technical Information page is misconfigured.

    The SHASIGN sent for the transaction does not match the SHASIGN calculated at Ogone’s end using the details of the order and the additional string (password/pass phrase) entered in the SHA-IN Signature field. This page is most likely displayed after clicking “Place Order”:

    WooCommerce Ogone Error 2

    Solution: Check your SHA-IN setting in the Ogone Back office and plugin configuration, as described in step 2 above.

Once you’ve checked these common configuration issues and confirmed setup is correct, please submit a support ticket, ideally with the debug log as an attachment, along with any relevant order notes and errors logged in the Ogone backoffice.

Frequently Asked Questions ↑ Back to top

Q: WooCommerce 2.2 added the ability to process automatic refunds. Does this gateway support automatic refunds?
A: Unfortunately automatic refunds are not possible with Ogone. We are following the developer documentation for updates and will add this to the roadmap if it becomes possible in the future.

Questions & Support ↑ Back to top

Have a question before you buy? Please fill out this pre-sales form.
Already purchased and need some assistance? Get in touch with a ninja via the help desk.

WooCommerce - the most customizable eCommerce platform for building your online business.

Back to the top