WooCommerce
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.
Overview
Item | Description |
---|---|
Countries | South Africa, Kenya, and Mauritius. |
Recurring payments | Use Woo Subscriptions for recurring or subscription payments. |
Refunds | Supports full or partial refunds. You must refund certain payment methods manually. |
Currencies | All currencies configured for your account. |
Pricing | See the Peach Payments website. |
Account activation | Requires 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:
- Log in to your WordPress administration dashboard.
- Go to Plugins.
- Click Add New Plugin.
- Search for Peach Payments Gateway in the plugin search bar and click Install.
- 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:
- Click WooCommerce.
- Select Settings from the list.
- Go to the Payments tab.
- In the payment methods list, click Peach Payments.
- Select Enable Peach Payments Gateway.
- To enable card and other payment methods, select Card Payments and Consolidated Payments from the Checkout Options list.
- 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.
- 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.
- Retrieve your Embedded Checkout credentials from the Peach Payments Dashboard and enter your client ID, client secret, and merchant ID into the relevant fields.
- Select Enable Card Storage to allow customers to store cards for their account. You must get permission from your customers before tokenising and storing their cards.
- Select Always use WooCommerce order IDs to overwrite custom order IDs generated by third-party plugins with WooCommerce order IDs.
- Select Enable Auto Complete for Virtual/Downloadable products to set the status of virtual products to complete when the payment is successful.
- Set Transaction Mode to Live.
- To accept card payments, enter the required information, which you can get from the Peach Payments Dashboard:
- Access Token.
- 3DSecure Entity ID.
- Recurring Entity ID: Required to accept recurring payments. If your recurring credentials do not appear in the Connect > WooCommerce section of the Dashboard, contact support to request recurring payments and the credentials.
- If you're using Embedded Checkout or accepting non-card payment methods, enter the Secret Token as well.
- 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. - Click Save changes.
- 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.
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:
- Log in to your WordPress administration dashboard.
- Go to WooCommerce > Status and select the Logs tab.
- In the upper right of the screen, select the applicable log from the list and click View.
- Copy the contents of the log and send it to Peach Payments for troubleshooting.
FAQ
If you run into any issues with WooCommerce, check the support knowledge base for the issue and solution:
- Why am I getting
No fast checkout brands defined, displaying default brands.
orIt appears that <your-site> is not yet ready to accept payments.
errors when running the Divi or Thrive theme? - How do recurring payments, payment notifications, refunds, balances, and order statuses work on WooCommerce?
- What do the order statuses in WooCommerce mean?
- Why am I getting a message that SSL is not enabled?
- Why am I getting an
Error [CURL] - The requested URL returned error: 401
error when doing a WooCommerce checkout integration?. - Can I allow my customers to enter their card details on the WooCommerce checkout, before the redirect to Peach Payments occurs so that they can check out faster? Yes, you can configure WooCommerce to display a card acceptance widget on your website. For this to work, configure the access token and 3-D Secure entity ID as described in step 14 of the Configure the plugin section.
- How do I show a Payflex, ZeroPay, or Mobicred instalment calculator on my store? For Payflex, follow their documentation. For ZeroPay, use this file. For Mobicred, follow their documentation.
The WooCommerce plugin listing also features some FAQ.
If you can't find the issue, contact support for assistance.
Updated 2 months ago