Description
Accept payments with Yoco
Whether you’re a small or medium-sized e-commerce business, the Yoco Payments for WooCommerce plugin is the perfect solution. We’ve designed our payment process to be both user-friendly and secure for both you and your customers.
Our pricing model is transparent and straightforward: we charge only per transaction, with no hidden fees, no monthly fees, and no plugin fees. Additionally, you’ll have access to real-time data and insights via your Yoco dashboard. This makes it super easy to manage a healthy cash flow.
Why use the Yoco Payments for WooCommerce plugin?
- No hidden or monthly fees
- Get paid the same day with Yoco Instant Payouts (if eligible)
- PCI DSS compliant
- Supports 3D Secure
- Your customers enjoy a seamless and safe payment experience
- Refund orders directly from your WooCommerce dashboard
Transparent pricing
Only pay when you get paid!
- Local Cards: 2.95% – 2.6% ex. VAT
- International Cards: 3.5% – 3.05% ex. VAT
- American Express: 3.5% – 3.05% ex. VAT
- Instant EFT: 2% ex. VAT
For further pricing details, please view pricing information.
Quick installation and setup
Step 1: Sign up with Yoco.
Step 2: Install Yoco for WooCommerce on your WordPress website.
Step 3: Activate Yoco on your WooCommerce WebShop.
Step 4: Do a test transaction to make sure you’re all set.
That’s it! You’re ready to accept payments.
For more details, please view Yoco Gateway for WooCommerce: User Guide.
All your sales orders in one place
The transaction info is captured in the Orders menu, and you can view all payments in your WordPress admin dashboard to stay on top of everything.
In addition, you can see all your online and in-store payments in one place in your Yoco Business Portal. You also benefit from Yoco business tools, and access to working capital.
Support
For any technical inquiries, please follow these steps:
- Send us the logs by navigating to WooCommerce > Status > Logs and selecting the logs that contain yoco and the date of the issue. Click View and copy the logs.
- Use this email ecommerce@yoco.com and send us the logs along with your website URL.
Screenshots
Showing how the Yoco Payments option will be on a website’s checkout page. 
Yoco Payments checkout page in Live mode. 
Yoco Payments checkout page in Test mode with the test card details and instructions to perform a test payment. 
Yoco Payments plugin settings. You can change the plugin mode to either Test or Live mode anytime.
Installation
Minimum Requirements
- WordPress version 5.0.0 or greater
- WooCommerce version 8.1.0 or greater
- PHP 7.4 or greater is required (PHP 8.0 or greater is recommended)
- MySQL 5.6 or greater, OR MariaDB version 10.1 or greater, is required
Installation instructions
Before you start, please make sure of the following:
- You have an active merchant account on Yoco
- You are using a compatible versions of WordPress, WooCommerce and PHP as a prerequisite for the plugin to work.
Case 1: It is the first time you installed the plugin:
- Go to WordPress Dashboard > Plugins > Add New Plugin
- In the search type “Yoco Payments”
- Install the latest version of the plugin > Click Activate
- Sign in to your Yoco Portal > Selling Online > Payment Gateway and Copy the Live & Test Secret Keys, one key at a time
- Go back to the Plugin Settings on the website and Paste the keys, one key at a time. Make sure to only use a copy & paste approach and not type the keys by yourself as it may 1. result in incorrect keys and failed activation.
- Click Save Changes
- Do a Test transaction to make sure the plugin is working
- Once you’re satisfied, turn the plugin into the Live mode and you’ll start getting real-time payments from your customers.
Case 2: You’re upgrading the plugin to the latest version:
- Go to WordPress Dashboard > Plugins > Installed Plugins > locate Yoco Payments plugin in the list
- Click Deactivate and then Delete
- Go to Plugins > Add New Plugin and search for Yoco – Install the latest version of the plugin. > Click Activate
- Go to Yoco Plugin Settings and Remove the Live and Test Keys values. Make sure the input fields are empty (it’ll give you an error which is ok, as the fields has been empty)
- Sign in to your Yoco Portal > Selling Online > Payment Gateway and Copy the Live & Test Secret Keys, one key at a time
- Go back to the Plugin Settings on the website and Paste the keys, one key at a time. Make sure to only use a copy & paste approach and not type the keys by yourself as it may result in incorrect keys and failed activation.
- Click Save Changes
- Do a Test transaction to make sure the plugin is working
- Once you’re satisfied, turn the plugin into the Live mode and you’ll start getting real-time payments from your customers.
Support
For any technical inquiries, please follow these steps:
- Send us the logs by navigating to WooCommerce > Status > Logs and selecting the logs that contain yoco and the date of the issue. Click View and copy the logs.
- Use this email ecommerce@yoco.com and send us the logs along with your website URL.
FAQ
-
What currencies does this plugin support?
-
Yoco currently accepts payments via Visa, Mastercard, American Express, and Instant EFT. All payments are made in South African Rands (ZAR).
-
How do I test the plugin?
-
Set the plugin to Test mode, fetch your Test Keys from the Yoco Business Portal and add these to the plugin configuration. Now try a test payment using the test card info. Note that test transactions won’t appear in the Yoco Business Portal. Using a real credit card in Test mode will also fail. Once you’re ready, set the plugin to Live mode and switch to the Live Keys for real transactions!
-
Where do I find documentation or support?
-
More detailed installation notes can be found in Yoco Gateway for WooCommerce: User Guide. or you can get in touch with us.
Reviews
اگست 16, 2024
1 reply
It worked great for almost a year then just stopped working.Followed all the procedures suggested on their website:Provide all logs, enable debug, provide a list of all plugins, create an admin login for them.Then spent 6 fruitless hours back and forth on WhatsApp with a chat centre operator who was acting as a liaison between me and their so-called “technical” team. And now it’s 3PM on a Friday afternoon, and not a peep from anyone for the last hour, so it looks like the site will be down all weekend, because, hey, they may be a 24/7 business but don’t expect to be in contact with a human being on weekends or between 5PM and 8AM on weekdays.
I am advising my client to move to Payfast, whose support is excellent.Yoco’s transaction fees may be lower than those of Payfast, but woe betide you if you need support
اکتوبر 17, 2023
1 reply
Had a problem when I ran the latest update. Turned out to be a server-side error and nothing at all to do with the plugin. Yoco support was absolutely outstanding, really efficient and most accommodating. Thank you!
اگست 25, 2023
2 replies
With the recent update 3.0.2 my Yoco Plugin which I’ve been using for months successfully on Wordpress just stopped working. After sending an email to Yoco (it took them hours to reply back) they suggested that I switch to a default theme, disable all plugins and basically set my website back to a fresh install of wordpress) All this after I clearly explained that I did not install new plugins – only after the Yoco update did problems arise. Always have two payment processors as Payfast is still holding up.
جولای 1, 2023
Lovely payment gateway. Bad integration plugin
جون 3, 2023
I am extremely dissatisfied with my experience with YOCO. I have been waiting for a response from their team regarding a server issue that has been persisting for an unacceptable amount of time. It is clear that they are unable to get their servers functioning properly, and what’s worse is their complete lack of communication.
Throughout this entire ordeal, YOCO has failed to keep me updated on the status of the issue. As a customer, I expect transparency and timely communication, especially when there are significant problems affecting their services. Instead, their silence has left me feeling frustrated and uninformed.
To make matters worse, I recommended YOCO to others based on my previous positive experiences, but now I feel like a fool for doing so. Their inability to address the server issue and their failure to keep customers informed has not only affected my own business operations but also damaged my credibility with others who relied on my recommendation.
I understand that technical difficulties can arise, but it is the responsibility of a company like YOCO to handle them efficiently and communicate with their customers throughout the process. Unfortunately, YOCO has failed miserably in this regard.
I cannot recommend YOCO to anyone at this point, given their poor customer service, lack of communication, and inability to resolve a server issue in a reasonable timeframe. It is evident that they prioritize their own convenience over the satisfaction and trust of their customers.
If you are considering using YOCO for your business needs, I strongly advise against it. Look elsewhere for a company that values customer support and is committed to resolving issues in a timely and transparent manner. YOCO has proven to be unreliable and unprofessional, and I regret ever engaging with their services.
مې 31, 2022
Absolutely the best payment gateway.
Efficiency at its best.
Contributors & Developers
“Yoco Payments” is open source software. The following people have contributed to this plugin.
Contributors
Translate “Yoco Payments” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
3.8.5
- Fix prevent GET request when order is missing Checkout ID.
- Bumped WP tested up to 6.8 and WC tested up to 9.8.
3.8.4
- Fix relative checkout url.
3.8.3
- Improve installation process.
3.8.2
- Fix duplicate refunds.
3.8.1
- Improved fix for duplicate payment complete notification.
3.8.0
- Add support for partial refunds.
- Fix duplicate payment complete notification.
3.7.1
- Improve payment complete implementation to allow use of actions and filters.
- WC tested up to 9.3.
3.7.0
- Update Payment Status Scheduler logic – Polling issue
- Add wp-env and e2e tests
- Telemetry webhook improvements
3.6.0
- Conditionally reset installation idempotency key.
- Extend the installation telemetry data.
3.5.0
- Add payment status polling as fallback method.
- Add simplify getting the logs to be shared with Yoco support.
- Update logging and REST response messages.
- Improve compatibility with themes (adjust icon display on checkout).
- Bumped WP tested up to 6.5 and WC tested up to 8.7.
3.4.0
- Add WooCommerce Blocks Checkout compatibility.
- Add notification and prevent loading Yoco Payment Gateway when WooCommerce is not active.
- Bumped WP tested up to 6.4 and WC tested up to 8.4.
3.3.2
- Add option to reveal API keys on settings page.
- Add version to yoco logger file name.
- Fix installation process when domain ends with /.
- Fix migration process.
3.3.1
- Fix installation spike when installation fail due to network issues.
3.3.0
- Add update scripts.
- Add admin notifications when Installation ID and Subscription secret are missing.
- Fix “Plugin doesn’t have a valid header” error.
3.2.0
- Add option to change gateway title and description
- Set API secret keys fields to password type
- Fix plugin self deactivation
3.1.0
- Add High Performance Order Storage compatibility
- Add debug logging
- Fix saving settings issue
- Miscellaneous fixes and updates
3.0.2
- Hotfix for merchant decimal settings causing amount issues
- Hotfix for an issue with refunds
3.0.1
- Hotfix for textdomain issue
3.0.0
- Integrate with online checkout API
- Integrate with installation API
- Setup REST endpoints for webhooks
2.0.12
- Added support for PHP version 8
2.0.11
- Update EFT pricing
2.0.10
- Security updates
2.0.9
- Fix notice message
2.0.8
- Miscellaneous fixes and updates
2.0.7
- Fix updates to admin settings for firms with invalid keys
2.0.6
- Miscellaneous fixes and updates
2.0.5
- Updates to admin settings
2.0.4
- Updates to admin settings
2.0.3
- Differentiate card and EFT status
2.0.2
- Added EFT as a payment option
2.0.1
- Reverted to the previous name for the plugin’s main file. If you have already upgraded to v2.0.0, upgrading to v2.0.1 will mean you’ll need to manually activate the plugin again. We encourage you to do this, as any upgrade from v2.0.0 will need this.
2.0.0
- Customer can save card for later use
- Integration of Yoco’s new payment APIs
1.53
- Added SVG checkout logo
1.52
- Updated checkout logo
- Improved error handling
1.51
- Improved retries for slow network conditions
- Updated branding
1.50
- Support legacy PHP 7 versions
1.49
- Better error recovery and retries
- Fix for misleading SQL error in logs
- Updated guidance and contact details
1.48
- Update to meet WP.org compliance review
1.47
- Handle transient connection errors with multiple retries
- More reliable error logging and reporting
- WordPress 5.6 test declaration
1.46
- Add WooCommerce version check support to plugin header
- Ensure order total is always consistent
- Add filter wc_yoco_popup_configuration
1.45
- Better error handling
- More useful error messages displayed to merchant
- Ensure Order status is updated correctly
1.44
- Bugfixes
1.43
- Fixed Virtual Product AutoComplete Bug
1.41
- Auto Complete Virtual Orders Variations Bugfix
1.40
- An improved payment experience that is simpler and quicker. This is the first of several improvements we will be releasing.
- Clearer error responses to give merchants better insight into failed transactions
- Automated order completion, on successful payment, for virtual or digital product orders
1.030
- Improved client error logging and Yoco client diagnostics
- Site in sub-folder fix
1.021
- Improved client error logging and Yoco client diagnostics
- Edge case rounding issue fix
- WooCommerce Notice on plugin admin page if trying to activate and WooCommerce is not active/installed
1.010
- Replaced Guzzle with WordPress native functions
- Improved client error logging and Yoco client diagnostics
- Updated Plugin Readme.md
1.000
- Initial Release.