Connect Peach Payments to your WooCommerce store.

Peach Payments offers a plugin for WooCommerce which allows you to accept online payments using all the payment methods offered by Checkout.


CountriesSouth Africa, Kenya, and Mauritius.
SubscriptionsWooCommerce Subscriptions can be used for payment subscriptions.
RefundsSupports full or partial refunds. Certain payment methods must be refunded manually.
CurrenciesAll currencies that you are configured for.
PricingSee the Peach Payments website.
Account activationRequires review by Peach Payments South Africa. Our sales team is always here to help; contact support for assistance.

Register account

To connect Peach Payments to your WooCommerce store, you must have a Peach Payments account.

Download and install the plugin

Install the plugin as follows:

  1. Log in to your WordPress admin dashboard.
  2. Go to Plugins.
  3. Click Add New.
  4. Search for "WC Peach Payments Gateway" in the plugin search bar to find WC Peach Payments Gateway and click Install.
  5. When the installation is complete, click Activate.

Configure the plugin


If you need to do extensive testing before going live, contact support for test credentials. Use those credentials when completing the steps below and set Transaction Mode to Integrator Test.

Configure the Peach Payments plugin on the WordPress admin dashboard as follows:

  1. Click WooCommerce.
  2. Select Settings from the list.
  3. Navigate to the Payments tab.
  4. Select Enable Peach Payments Gateway.
  5. Select all the payment methods that you want to enable from the Payment Methods list. Remember that Peach Payments must have activated these payment methods for you.
  6. Select Enable Card Storage to allow customers to store cards for their account.
  7. Select Always use WooCommerce order IDs if you want to overwrite custom order IDs generated by third-party plugins with WooCommerce order IDs.
  8. Select Enable Auto Complete for Virtual/Downloadable products if you want to set the status of virtual products to complete when the payment is successful.
  9. Set Transaction Mode to Live.
  10. To accept card payments, enter the required information, which you can either get from the Peach Payments Dashboard or Peach Payments support, or by logging in to the Peach Payments Console and navigating to Merchants > <your merchant> > Development > API Credentials:
    • Access Token
    • 3DSecure Channel ID, also called the entity ID
    • Recurring Channel ID, only required if you want to accept recurring payments
  11. To accept other payment methods, enter the Secret Token as well.
  12. To optionally enable webhooks, send support your domain and ask them to configure:
    1. <your-domain>/?wc-api=wc_payon_webhook_peach_payments for card payments and <your-domain>/?wc-api=wc_switch_webhook_peach_payments for non-card payment methods.
    2. Peach Payments completes the configuration and sends you the card webhook decryption key to enter into the relevant field.
  13. Click Save changes.


Deprecated fields and rolling back

  • User Login and User Password have been deprecated and are no longer needed to configure the plugin.
  • If errors occur after upgrading to version 3 of the plugin, you can easily roll back to version 2.0.14 by clicking ROLLBACK TO VERSION 2.0.14.
WooCommerce configuration.WooCommerce configuration.

WooCommerce configuration.


For more information on the Peach Payments WooCommerce plugin, please see the WordPress plugin documentation.

Gather and send logs

In some cases, it might be necessary for you to gather logs to submit to Peach Payments for troubleshooting:

  1. Log in to your WordPress admin dashboard.
  2. Navigate to WooCommerce > Status and select the Logs tab.
  3. In the upper right of the screen, select the applicable log from the list and click View.
  4. Copy the contents of the log and send it to Peach Payments for troubleshooting.

Peach Payments logs in WooCommerce.


If you run into any issues with WooCommerce, check our support knowledge base for the issue and solution:

The WooCommerce plugin listing also features a number of FAQ.

If you can't find the issue, contact support for assistance.