Take payments with Yoco (South Africa)

If your business is in South Africa, customers can pay by card through your own Yoco account. The money goes straight to your Yoco account, in rand.

Get your keys

1. Sign in to the Yoco app and open Sales channels → Checkout API → How to connect.
2. On the Test keys tab, copy the Test secret key (it starts with sk_test_). It works straight away.
3. For real payments, open the Live keys tab and copy the Live secret key (sk_live_). Live keys unlock once you add your website's address under Verified Domains on the same page, so publish your site first.

Connect Yoco

1. Open Site settings → Payments and choose Yoco.
2. Paste your Test secret key, set Mode to Test and save. We set up payment confirmations on your Yoco account for you.
3. Place a test order on your site and pay with the test card shown in the Yoco app. The order shows as paid in Store → Orders.
4. When you are ready to sell, paste your Live secret key, switch Mode to Live and save. Both keys stay saved, so you can switch back to test at any time.

Good to know

• Yoco only takes payments in rand (ZAR), and nothing under R2.
• Refunds from Store → Orders go back through Yoco to the customer's card.
• Yoco charges its own fees.
• No Yoco account yet? You can still take orders: see Take orders on WhatsApp.