
Connecting Your Payment Gateways (Part 1): Yoco, PayFast & Paystack
Get paid directly into your own account. This step-by-step guide shows how to connect Yoco, PayFast, and Paystack to your store — where to find each gateway’s keys, exactly what to paste where, and how to go from test to live.
On Safari Shop Builder, customers pay you directly. There’s no middleman holding your money — you connect your own payment gateway, and card payments land straight in your account. This guide (Part 1) walks through the three most popular gateways for South African sellers: Yoco, PayFast, and Paystack. Part 2 will cover the rest.
Where payment setup lives
All of this happens in one place. From your dashboard:
- Open the store you want to set up.
- Go to Settings, then the Payments tab. (On your dashboard, a store that still needs payments shows a “Set up Payments” shortcut that takes you straight there.)
- Find the gateway you want under Online Payment Gateways, click Enable, paste in your keys, and click Save.
You can turn on more than one — give your customers a choice at checkout. Your keys are stored securely and shown masked after saving.
Test first, then go live
Every gateway gives you two sets of keys: test and live. Test keys (they contain the word test, e.g. pk_test_… / sk_test_…) let you run a fake checkout to confirm everything works without moving real money. When you’re happy, swap in your live keys (e.g. sk_live_…) and real payments start flowing. Always test before you share your store.
Yoco
Yoco is the most popular card processor for South African businesses, and the quickest to connect — you only need one key.
- Log in to your Yoco dashboard and go to Developers > API Keys.
- Copy your Secret Key (starts with sk_test_ or sk_live_).
- In your store’s Payments tab, enable Yoco and paste the key into Secret Key. The Public Key field is optional — you can leave it blank.
- Click Save. Done.
PayFast
PayFast is a long-trusted South African gateway that supports all the major banks. It needs three details, including a passphrase for security.
- Log in to your PayFast dashboard and open your merchant settings.
- Copy your Merchant ID and Merchant Key.
- Set a Passphrase in PayFast (under your integration/security settings) and copy it. PayFast uses this to sign and verify payments, so it must match.
- In the Payments tab, enable PayFast and fill in Merchant ID, Merchant Key, and Passphrase.
- Click Save.
Tip: the passphrase is required here for security — make sure the one you set in PayFast is exactly the one you paste into your store.
Paystack
Paystack works across South Africa, Nigeria, Kenya, and Ghana, and supports cards, bank transfers, mobile money, and USSD — which is why it’s a great all-rounder if you sell across African markets.
- Log in to Paystack and go to Settings > API Keys & Webhooks.
- Copy your Public Key (pk_…) and your Secret Key (sk_…).
- In the Payments tab, enable Paystack and paste both keys into Public Key and Secret Key. The Webhook Secret field is optional.
- Click Save.
Which one should I choose?
- Selling mainly in South Africa? Yoco is the fastest to set up; PayFast is a solid, familiar option for local shoppers.
- Selling across Africa (Nigeria, Kenya, Ghana too)? Paystack covers the most ground in one gateway.
- Not sure? Turn on more than one and let customers pick their preferred method at checkout.
Before you share your store
- Run a test checkout with test keys to confirm the flow end to end.
- Switch to your live keys when you’re ready to accept real payments.
- Double-check the keys are pasted with no extra spaces — a stray space is the most common reason a gateway rejects a payment.
That’s Yoco, PayFast, and Paystack connected — money straight to you, no middleman. Open your store’s Payments tab to get started, and watch for Part 2, where we cover the remaining payment options. Go to your dashboard to set up payments now.
