Skip to main content
How to Refund a Payment

Whether you’re trying to figure out a full or partial refund, or a cash refund, here’s everything you need to know.

Updated over a month ago

Refund timing guidelines

  • Debit card payments can only be refunded on the same day as the original payment.

  • If you process a refund before 7pm on the day the payment was made, the refund will be instant.

  • If you process a refund after 7pm, or the following day, your customer will receive their money within 5–7 working days.


Full refunds

It’s quick and easy to give full refunds from the Yoco Mobile App, Web App, and POS App, as well as directly from the Yoco Khumo, Khumo Print, Neo, and Neo Touch card machines.

Refunds can only be successfully processed if you have sufficient funds in your Yoco balance (i.e. your pending Payout amount) to cover them. Not sure of your current balance? Check it here.

Processing refunds from the Yoco App

  1. Log in to the Yoco Mobile App, Web App, or POS App.

  2. Select the Sales tab.

  3. Find the sale you want to refund and click on it to view the Sale Details.

  4. Click the Refund quick action button.


6. Click Continue to confirm that you want to proceed with the refund.

7. Choose a reason for the refund (this is for your reference only).

8. Click Request refund – make sure you’re ready because refunds can’t be undone!

9. The refund will appear as a new transaction in your Sales History. The original transaction will now show the refunded amount and its status will change from 'Approved' to 'Refunded'.

Processing refunds from your Yoco card machine

  1. Go to the Sales History on your Yoco Khumo, Khumo Print, Neo or Neo Touch.

  2. Find the sale you want to refund and select it to view the Sale Details.

  3. Select Refund, and enter the refund PIN that has been sent to your phone.

  4. Choose a reason for the refund (this is for your reference only).

  5. Press Refund – make sure you’re ready because refunds can’t be undone!

  6. The refund will appear as a new transaction in your Sales History. The original transaction will now show the refunded amount and its status will change from Approved to Refunded.

💡Your refund will take a few seconds to process. Once it’s done, the on-screen message will change to ‘Refund Failed’ or ‘Refund Approved’. If the ‘Refund Processing’ message doesn’t change, refresh your screen and you should see the refund status.

💵 What about cash refunds?
If you’re refunding a cash payment from the Yoco Mobile App, Web App, POS App or your Yoco card machine, process a refund as normal, but then hand the cash over to your customer.


Partial refunds

From time to time, you may need to issue a partial refund. For example, you may have decided not to charge shipping or delivery fees, or your customer may have returned some of the items they ordered.

Partial refunds can be processed for any order that has been paid for with a Visa, MasterCard or Amex card, or Apple Pay.

💡Partial refunds are not yet supported for instant EFT.

Partial refunds can be issued from the Yoco Mobile and Web App, the Yoco Checkout API, the WooCommerce and Shopify Admin portals.

💡Partial refunds are not currently supported on the Yoco card machines, Yoco POS App or Wix, but Wix transactions can be partially refunded from the Yoco Web App or Mobile App.

Processing partial refunds from the Yoco App

  1. Log in to the Yoco Mobile App or Web App.

  2. Select the Sales tab.

  3. Select Sales History.

  4. Find the sale you want to refund and select it.

  5. Click the Refund quick action button.

  6. Select Continue to confirm that you want to proceed with the refund.

  7. Click Change amount and enter the amount you wish to refund.

  8. Choose a reason for the refund (this is for your reference only).

  9. Click Request refund.

💡The refund will appear as a new transaction in your Sales History. The original transaction will now show the refunded amount and its status will change from Approved to Refunded.

Processing partial refunds from Yoco Checkout API integration

Follow these steps to modify your Checkout API integration:

  1. Update your Checkout refund request to support a nullable ’amount’ field, as explained here. If the amount is null, the full remaining refundable balance will be refunded.

  2. Make sure that your webhook implementation is updated to handle both full and partial refund events. For partial refunds, the event will include a ’refundableAmount’ field, which indicates the remaining balance after the refund. Find out more here and here.

  3. Once the integration is done, do a test payment of R5.00, then try to refund R2.00 or more.

Processing partial refunds from WooCommerce Admin

  1. Log in to your WooCommerce website admin.

  2. Go to WooCommerce > Orders to find the order you want to refund.

  3. View the Order Details page and click Refund.

  4. Select which item(s) you want to refund (these are editable).

  5. Click Refund Rx.xx via Yoco Payments.

  6. Click Ok to confirm that you’d like to proceed.

  7. The order status will reflect as refunded.

Processing partial refunds from Shopify Admin

  1. Log in to your Shopify Admin portal.

  2. Go to Orders and find the one you want to issue a partial refund for.

  3. Click Refund and enter the refund amount or, if the order has more than one item, select which items(s) you want to refund.

  4. Enter a reason for the refund and click Refund.


Partial refunds and Products

If you are using Stock and Products, you will need to modify the stock quantity manually. Partial refunds are currently done at an order level, so this means your stock inventory won’t automatically update when you issue a partial refund. So for example, if a customer purchases two units of Product A and returns one, you can process a refund for one unit of Product A, but you’ll need to manually adjust the available stock of Product A in the Yoco App. Click here to read our stock management guide.


Refund troubleshooting

Having trouble with your refunds? Don't worry, we've got your back!

Refund request failed

There are three reasons you might see this error message while trying to process a refund.

1. Insufficient funds

Refunds often don’t succeed because your pending Yoco payout balance is too low to cover the refund amount (remember that we pay you out at the end of every day).

When this happens, you have several options available to you:

  • Wait for new sales to come in and once your balance is enough to cover the refund amount, the system will automatically issue the refund.

  • EFT the refund amount directly to your client – just make sure to let us know so that we can cancel the pending refund on our side.

  • Contact a member of our Support Team via our in-app chat.

💡To avoid having your refund request fail due to insufficient funds, check your Yoco balance here.

2. Connectivity issues

Another reason your refund request may not be succeeding is network or internet connection issues. If you think this may be the problem, try:

  • Switching to your WiFi or SIM network.

  • Processing the refund from the Yoco Web/Mobile App.

3. Bank-related matters

Just like normal transactions, refunds depend on the cardholder’s bank accepting and processing them. Here are some of the most common reasons a refund request might fail:

  • The bank card used to pay for the original transaction doesn't allow for refunds (this is more common with debit and international cards).

  • The bank account linked to the bank card used doesn't allow for refunds.

  • The bank account/card used has been stopped/frozen.

  • The original transaction has already been refunded.

  • The original transaction was never approved.

  • The original transaction is older than 90 days.


Refund PIN error

When refunds are done on Yoco card machines, a refund PIN is sent via SMS to the mobile number linked to your profile as a special security measure. If you’re not receiving the PIN, make sure that the correct mobile number is linked to your profile and update it, if necessary. Alternatively, you can try doing the refund from the Yoco Mobile/Web App using your admin login details.


Need a Refund for Your Yoco Card Machine?

Simply open your Yoco app and ask to speak to a consultant via chat – our specialists are ready to guide you through the device refund process and help with any questions you have. For fastest assistance, please have your purchase details ready.

Read more about our Shipping & Returns policy here

Did this answer your question?