Skip to main content
Yoco is a leading payment provider in South Africa, offering simple and affordable card payments for businesses of all sizes. storekit integrates directly with Yoco for South African stores.
Yoco
Yoco is a standalone payment integration, completely separate from storekit Payments (Adyen). For now, South African stores use Yoco instead of storekit Payments.

​
How It Works

When a customer checks out at a Yoco-enabled store:
  1. Customer completes their order and proceeds to payment
  2. They’re redirected to Yoco’s secure checkout page
  3. Customer enters their card details or pays with a saved card
  4. Payment is processed by Yoco
  5. Customer is redirected back to your store with confirmation

​
Connecting Yoco

Unlike other payment methods, Yoco requires you to enter your API secret key in storekit:
1

Create a Yoco Account

If you don’t already have one, sign up for Yoco and complete their onboarding process.
2

Get Your Secret Key

Log in to the Yoco App and navigate to Sales > Payment Gateway. You’ll see your Test Secret Key and Live Secret Key.
3

Enter Your Secret Key in storekit

In your storekit dashboard, go to Store Settings > Yoco and paste your secret key.
  • Use the Test Secret Key while setting up and testing
  • Switch to the Live Secret Key when you’re ready to accept real payments
4

Start Accepting Payments

Once configured, Yoco will automatically appear as the payment method at checkout.

​
Features

FeatureSupported
Card paymentsYes
RefundsYes
WebhooksYes
Line item detailsYes

​
Availability

RegionCurrency
South AfricaZAR

​
Refunds

Refunds for Yoco orders work the same as other payment methods:
  1. Go to the order in your storekit dashboard
  2. Click Refund
  3. Enter the refund amount
  4. The refund is processed through Yoco and the customer is notified
Refunds are processed directly through Yoco’s API. The refund will appear in the customer’s account according to Yoco’s standard processing times.

​
Payouts

Yoco handles payouts directly to your South African bank account. Payout timing and fees are determined by your Yoco account settings, not storekit. To view your payouts and transaction history, log in to your Yoco Portal.

​
Disconnecting Yoco

If you need to remove your Yoco integration:
  1. Go to Store Settings > Yoco in your storekit dashboard
  2. Remove your secret key
  3. Save the settings
Removing your Yoco secret key will prevent your store from accepting payments until you re-enter it or set up an alternative payment method.

​
Troubleshooting

​
Invalid Secret Key

If your secret key isn’t working:
  • Ensure you’re copying the full key from the Yoco App
  • Check you’re using the correct key (Test vs Live)
  • Verify your Yoco account is fully verified and active

​
Payments Not Working

If payments aren’t processing:
  • Check you’ve entered the Live Secret Key (not Test) for real payments
  • Verify your Yoco account status in the Yoco App
  • Ensure your store is set to the South Africa region
For further assistance, contact support.

​
Learn More

Visit Yoco to learn more about accepting payments in South Africa.