Skip to main content
Yoco Gateway for WooCommerce: User Guide
Updated over a week ago

What Yoco’s integration gives you

The Yoco WooCommerce plugin gives your customers a fantastic payment experience and can be accessed here. It offers:

Easy, flexible payments

Popular payment methods: When installing Yoco's plugin, you instantly unlock a wide range of popular payment methods. Within minutes, you'll be able to accept payments via Visa, Mastercard, American Express, and Instant EFT directly on your WooCommerce webshop. Streamline the payment process for your customers, making it effortless for them to pay, and witness your business flourish!

A simple fee structure

Transparent Yoco fees that shrink as you grow: Pay only a small percentage on each transaction. No lock-in contracts. No setup fee. Learn more about how our fees go down as your sales go up, and never increase again - check out our sliding fee structure here.

Oh so convenient

Easy integration: In your WooCommerce back office, go to the ‘Plugins’ page and install

Yoco with a single click. That’s all it takes to get up and running.

User friendly dashboard: Keep track of your orders and payments in real-time with your Yoco App.

Dedicated and Comprehensive Support: We have several support channels to help you, in whatever way is most convenient for you.

Get started with Yoco for Woo:

How do I activate Yoco for WooCommerce on my WordPress site?

To receive payments with Yoco, you need a Yoco profile. Please continue to Step 2 if you’re already part of our community.


​Step 2: Install Yoco for WooCommerce on your WordPress website

  1. Log into WordPress and go to ‘My Sites > WP Admin’.

  2. Go to ‘Plugins > Add new’.

  3. In the search bar, search for ‘Yoco Payments’.

  4. Click on ‘Install Now’.

  5. Choose ‘Activate’ when the installation is done.


​Step 3: Activate Yoco on your WooCommerce webshop

  1. Find your unique Yoco API keys in your Payment Gateway page in the Sales tab of your Yoco Mobile or Yoco Web App here.

  2. Copy the Live API keys or the Test API keys. Use the Test API keys to test if payments work with a test card. The Live API keys are for real transactions.

  3. Go back to your WordPress Admin Panel.

  4. Open ‘Plugins > Yoco Payment Gateway > Settings’.

  5. Enter the API keys.

  6. Choose ‘Save Settings’.

​Step 4: Do a test transaction to make sure you’re all set

Although not required, we recommend that you test that the integration is working smoothly end-to-end by processing a small amount for payment – no less than R2.00 (ZAR). This gives you peace of mind that everything is running as expected.

Instant EFT for WooCommerce

Instant EFT gives online customers access to their internet banking to make an Electronic Funds Transfer that gets instantly verified. Instant EFT through Yoco is integrated with major banks in South Africa enabling access for 95%+ of users.

Find out more about Yoco Instant EFT here.

Apple Pay for WooCommerce

Apple Pay is a digital wallet that allows your customers to make quick, secure payments using Apple devices like iPhones, iPads, Apple Watches, and Macs. Customers can use Apple Pay for contactless payments in store and to make online purchases without having to enter card details manually. Find out more here.

Google Pay for WooCommerce

Google Pay is a digital payment platform that allows your customers to make payments using Android devices like smartphones and tablets. Customers can use Google Pay for contactless payments in store and to make online purchases without having to enter card details manually.

Notifications

When customer transactions are successfully completed, you and your customers will each receive payment confirmation emails from Yoco. Find out more about managing your Yoco communication preferences here.

Managing refunds between Yoco and WooCommerce

When processing refunds through your Yoco App, your WooCommerce orders won't automatically update to reflect these changes. Follow these steps to ensure your WooCommerce orders match the status and amount shown in your Yoco app:

Steps to synchronise refunds:

  1. Ensure you have the latest version of the Yoco Payments Plugin installed on WooCommerce

  2. From WooCommerce Admin, select WooCommerce from the left side-bar, then select Orders

  3. Locate the order that was refunded on the Yoco App

  4. Select Edit order

  5. Find the Order Actions block on the edit order screen, and select Yoco: Sync Refunds from the dropdown list

  6. Click Update

Once completed, the order status will change to Refunded, and the refund amount will match what's displayed on your Yoco App.

Note: This process is only necessary when managing refunds. Regular payment transactions synchronise automatically between platforms.

Helpful WooCommerce Resources

Did this answer your question?