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.
Recurring paymentsUse Woo Subscriptions for recurring or subscription payments.
RefundsSupports full or partial refunds. You must refund certain payment methods manually.
CurrenciesAll currencies configured for your account.
PricingSee the Peach Payments website.
Account activationRequires review by Peach Payments South Africa. Contact support for assistance.

Register account

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

Video showcase

The following video showcases WooCommerce payment methods, security, subscriptions, refunds, and more:

Install the plugin

Install the plugin as follows:

  1. Log in to your WordPress administration dashboard.
  2. Go to Plugins.
  3. Click Add New Plugin.
  4. Search for Peach Payments Gateway in the plugin search bar and click Install.
  5. When the installation completes, click Activate.

Configure the plugin


To test before going live, use the sandbox Dashboard to get the sandbox credentials from the WooCommerce section. Use these credentials when completing the steps below and set Transaction Mode to Integrator Test.

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

  1. Click WooCommerce.
  2. Select Settings from the list.
  3. Go to the Payments tab.
  4. In the payment methods list, click Peach Payments.
  5. Select Enable Peach Payments Gateway.
  6. To enable card and other payment methods, select Card Payments and Consolidated Payments from the Checkout Options list.
  7. From the Consolidated Payments Logos list, select the payment methods whose logos you want to be visible on your website before customers get to your checkout. Remember that Peach Payments must have activated these payment methods for you.
  8. To embed the checkout experience on your website instead of redirecting customers to the Peach Payments checkout page, select Enable Embedded Checkout.


    Embedded Checkout does not support certain payment methods.

  9. Retrieve your Embedded Checkout credentials from the Peach Payments Dashboard and enter your client ID, client secret, and merchant ID into the relevant fields.
  10. Select Enable Card Storage to allow customers to store cards for their account.
  11. Select Always use WooCommerce order IDs to overwrite custom order IDs generated by third-party plugins with WooCommerce order IDs.
  12. Select Enable Auto Complete for Virtual/Downloadable products to set the status of virtual products to complete when the payment is successful.
  13. Set Transaction Mode to Live.
  14. To accept card payments, enter the required information, which you can get from the Peach Payments Dashboard:
  15. If you're using Embedded Checkout or accepting non-card payment methods, enter the Secret Token as well.
  16. To enable webhooks for non-card payment methods, follow the instructions in the webhook documentation, using the <your-domain>/?wc-api=wc_switch_webhook_peach_payments URL format. To enable webhooks for card payments, send support your domain and ask them to configure <your-domain>/?wc-api=wc_payon_webhook_peach_payments as your webhook. Peach Payments completes the configuration and sends you the card webhook decryption key to enter into the relevant field.
  17. Click Save changes.
  18. To add your domain to the Peach Payments allowlist, follow the instructions in the allowlist documentation.


Deprecated fields and rolling back

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

WooCommerce configuration.


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

Gather and send logs

Sometimes, it might be necessary for you to gather logs to submit to Peach Payments for troubleshooting:

  1. Log in to your WordPress administration dashboard.
  2. Go 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.

Peach Payments logs in WooCommerce.


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

The WooCommerce plugin listing also features some FAQ.

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