060 279 5587 info@sitect.co.za 139 Davies Street, Doornfontein, Johannesburg, 2001 Gauteng, SA
E-Commerce · Payment Gateway Integration

Yoco, Payfast, Peach & Stripe — wired up right.

Most "payment integrations" are 80% done — and the missing 20% is what breaks Black-Friday. We wire up SA & international gateways with reconciled webhooks, 3DS 2.0 tested on real cards, refund flows verified, and an admin dashboard your finance team can actually use.

From R3k · per gateway 5–10 working days typical Real-card tested · not just sandbox
Step 1 · Card entry
Mzansi Roastery
Amount due
R2 850.00 ZAR
PCI-DSS L1 via Yoco
Step 2 · 3D Secure 2.0
Verify it's you SMS sent to •••• 5872
Resend in 27s · Issuer: FNB
Step 3 · Confirmed
Payment confirmed R2 850.00 captured
ReferencePAY-2026-0427
MethodVisa •••• 4242
VAT (15%)R371.74
TotalR2 850.00
Webhook reconciled 0.4s
SA-first gateways
YYoco
PFPayfast
PPeach
OOzow
International
SStripe
PPPayPal
Where most integrations go wrong

The 4 failure modes we see most often

Wiring up a gateway looks deceptively simple — until a webhook is missed, a refund silently fails, or 3DS rejects half your shoppers. Here's where the cracks usually open.

Failure 01

Tested in sandbox. Failed on the first live card.

Sandbox cards don't behave like real cards. They skip 3D Secure flows, ignore issuer-bank quirks, return rosy success responses, and never trigger the edge-case error codes a real FNB or Standard Bank card will throw at 11pm on Black Friday.

What it costs: declined transactions on launch day with no idea why, and a finance team chasing PSPs by phone.
Failure 02

Webhook fires once, fails, never retries.

Gateways send a webhook to confirm payment. If your endpoint is slow, returns 500, or fails to verify the signature, the gateway gives up. Your order stays in "pending payment" forever even though the customer was charged.

What it costs: orphaned payments, support tickets, a finance team manually reconciling every Monday.
Failure 03

Refunds are "soon" — until they aren't.

Most integrations bolt on the happy-path purchase flow and leave refunds half-built. Partial refunds aren't supported, refund webhooks aren't reconciled, and your team ends up emailing the PSP for every R200 return.

What it costs: POPIA/CPA exposure on consumer rights, support hours, and refund SLAs you can't keep.
Failure 04

Card data touches your own servers.

If the card form sits on your domain and POSTs raw PAN through your app, you've just made yourself PCI-DSS in scope — and almost certainly out of compliance. The right answer is iframe / hosted fields / Shop Pay / redirect — but it's often skipped.

What it costs: a breach that puts you on a regulator's radar, plus card-brand fines.
SA & international gateways

The gateways we integrate — and what each one does well

No gateway is best at everything. Most SA stores end up with 2–3 wired up: a primary card processor, an instant-EFT option, and an international card route. Here's our honest take on each.

Yoco Online

SA · Card · 3DS 2.0

Excellent for low-to-mid volume SA merchants. Best-in-class onboarding, clear fees (~2.95% inc. VAT), great support, simple API. Default choice for new SA stores.

Recommended3DS 2.0HostedRecurring

Payfast (Network)

SA · Card · EFT · QR · Wallets

Most-recognised SA gateway. Card + Instant EFT + Snapscan + Zapper + Mobicred + Masterpass — all in one redirect. Good for stores that need the widest payment-method coverage.

Most methodsRecurringSplit pay

Peach Payments

SA · Card · MoMo · Intl. cards

Stronger anti-fraud, sophisticated risk-rules engine, supports international cards better than most SA gateways. Choice for higher-volume stores with risk concerns.

Intl. cardsRisk engineTokenisation

Ozow

SA · Instant EFT only

Belongs in every SA checkout. Instant EFT for card-shy shoppers, ~1.5% fee, settles same-day. Pair with a card gateway — never use as the only option.

Card-shy1.5%Same-day

PayGate (DPO)

SA · Card · Enterprise

Enterprise SA gateway with deep PSP integrations, vault tokenisation, multi-currency, and stronger MoR options. Choice for high-volume, multi-store, or B2B-heavy merchants.

EnterpriseVaultMulti-currency

Stripe

Intl · Card · Apple/Google Pay

Use for international cards, Apple/Google Pay, and stores selling primarily into USD/EUR/GBP markets. Note: Stripe is now live in SA but onboarding still varies by sector.

Intl. shoppersApple PayGoogle Pay

PayPal

Intl · Wallet

Largely for inbound international shoppers — diaspora customers, eBay/Etsy crossover audiences, and US-based B2B buyers. SA settlement to FNB Forex account.

DiasporaFNB Forex

SnapScan

SA · QR · Wallet

QR-code payments via the SnapScan app, popular for in-store POS but also embeddable in online checkout. Useful for low-value, mobile-first shoppers.

QRMobile

Zapper

SA · QR · Wallet

Alternative QR wallet to SnapScan, common with FNB customers. Often added together with SnapScan to give shoppers full QR-wallet choice.

QRFNB
How we actually wire it

The 8 things every integration ships with

Every Sitect gateway integration ships with the same 8 elements — none are "phase 2", none are optional. This is what makes an integration production-grade vs sandbox-grade.

1. PCI-safe card capture

Card data never touches your servers. Iframe / hosted fields / drop-in component on the gateway's domain — keeps you out of PCI scope.

  • Hosted-field SDKs by default
  • SAQ-A scope (the easiest)

2. 3DS 2.0 tested on real cards

We test on at least one card per major SA issuer — FNB, Standard, ABSA, Nedbank, Capitec, Discovery — to verify OTP flows actually complete.

  • Friction-vs-frictionless tuning
  • Issuer-specific error handling

3. Idempotent webhook handler

Webhooks are signed, verified, and replay-safe. Duplicate webhooks don't double-credit; missed webhooks reconcile on the next poll.

  • Signature verification
  • Idempotency keys
  • Replay + reconcile cron

4. Full refund flows

Full and partial refunds wired into your admin. Refund webhooks reconciled. Status synced back to the order. Notification emails sent.

  • Partial & full refunds
  • Refund-webhook reconciliation

5. Admin payments dashboard

Your finance team gets a real dashboard — payments list, filters by date / gateway / status, refund button, export to CSV, deep-link to the gateway's record.

  • Filters & CSV export
  • One-click refunds

6. SARS tax invoice on success

Automatic SARS-compliant tax invoice generated on payment confirmation — sequential numbers, all required fields, archived as PDF, emailed to customer.

  • 15% VAT broken out
  • Sequential numbering

7. Customer-facing notifications

Branded receipt email on success, failure email with retry link, refund-confirmation email — all using your templates. Optional WhatsApp + SMS.

  • Receipt / failure / refund
  • WhatsApp / SMS optional

8. Alerting + monitoring

Webhook failures, signature mismatches, and unusually-low success rates page your team via Slack / WhatsApp. You know within minutes, not next-day.

  • Slack / WhatsApp alerts
  • Success-rate baselines
Security & compliance

Built to keep you out of PCI & POPIA trouble

The cheapest way to handle payment security is to never touch the data in the first place. Every Sitect integration is engineered to keep your store in the easiest compliance bucket possible.

PCI-DSS SAQ-A

Hosted-field architecture keeps you in the lightest PCI scope. Annual self-assessment instead of an audit.

3DS 2.0 enforced

Strong Customer Authentication required for every transaction unless the gateway exempts it (low-value / trusted device).

Webhook signing

HMAC signature verification on every incoming webhook. Unsigned or mismatched payloads logged + dropped.

Tokenisation

Saved cards stored only as gateway tokens. No card details (even masked) live in your database.

POPIA-aligned

Cardholder PII processing documented, retention policies, customer data-export and delete-flows on request.

Fraud signals

Velocity rules, AVS/CVV checks enforced, BIN-blocking, geo + IP fraud scoring routed back to gateway risk engines.

HTTPS everywhere

HSTS preload, modern TLS only, mixed-content blocked, CSP locked down to the gateways you've enabled.

Audit log

Every payment, refund, webhook, and admin action logged immutably. SARS / POPIA / dispute-friendly.

What you walk away with

Everything in the handover package

One fixed scope, no hidden phase-2 items, your team trained to handle 95% of payment-ops issues without us.

Production integration

Live, tested gateway integration with hosted card capture, 3DS 2.0, webhooks, refunds, and order-status sync — all running in your production environment.

Admin payments view

Filterable, sortable payments list with refund buttons, CSV export, deep-links to the gateway, and a daily summary email to your finance team.

Reconciliation cron

Daily reconciliation job that compares gateway records vs your orders, flags discrepancies, and auto-resolves common cases. Slack alert on unreconciled rows.

SARS tax-invoice flow

Tax-invoice generator triggered on payment success, archived to S3, emailed to the customer, available in your admin and the gateway audit-log.

Runbook + Loom training

15-page payments runbook (testing checklists, refund procedure, dispute response, monthly recon) plus Loom tutorials walking your team through each.

30-day defect warranty

Any payment-flow defect we introduce, we fix free for 30 days post go-live. We monitor your alerts during the window and respond inside 4 business hours.

From kick-off to live

A predictable 5-day to 2-week build

Single-gateway integrations take a week. Multi-gateway with reconciliation takes two. Heavier B2B / split-payment / subscription work takes 3–4 weeks. Here's how it runs.

1

Discovery

Gateway choice, fees, MoR setup, test cards collected, sandbox credentials issued.

Day 1
2

Sandbox build

Hosted card capture, 3DS flow, webhooks, refund flow built & tested in sandbox.

Days 2–5
3

Admin + recon

Payments dashboard, refund UI, reconciliation cron, SARS invoice generator.

Days 4–7
4

Live testing

Real-card tests on every major SA issuer, 3DS flows verified, refund verified.

Day 8
5

Go-live + tune

Production go-live with you, alerting wired up, 30-day warranty + monitoring.

Days 9–10
What "wired right" earns

The numbers behind a proper integration

Indicative metrics from recent SA gateway rewires, measured 60 days after go-live. Bigger gains come on stores that previously had a half-built integration in place.

+18%
Checkout completion
From 3DS flow tuning alone
−92%
Orphan payments
Idempotent webhooks + recon cron
~2h
Monthly recon time
Down from ~12h manual
0
PCI scope upgrades
Across 18 active integrations
Indicative pricing — ZAR, ex VAT

Three ways to wire up payments

All prices assume you already have a store (Shopify, WooCommerce, custom Laravel/Node/etc) and an active merchant account with the gateway. 50% on signature, 50% on go-live.

Single Gateway

One gateway · standard card flow
From R3 000 · ex VAT
5 working days · 30-day warranty
  • 1 gateway integration (e.g. Yoco)
  • Hosted card capture + 3DS 2.0
  • Idempotent signed webhooks
  • Full + partial refund flow
  • Real-card tested on 3 SA issuers
  • Runbook + Loom training
Start a Single quote

Custom Flows

B2B · subscriptions · split-pay · marketplaces
From R9 000 · ex VAT
3–4 weeks · 60-day warranty
  • Recurring billing & subscriptions
  • B2B net-7/14/30 invoicing
  • Split-payments / marketplace payouts
  • Saved-card tokenisation + dunning
  • Custom risk-rules engine
  • 60-day defect warranty
Talk to us about Custom
FAQ

The questions we get asked most

Honest answers about gateways, fees, PCI scope, MoR, refunds, and what to do when something breaks.

Which SA gateway should I actually use?
Honest answer: it depends on your volume, AOV, customer base, risk profile and how international your buyers are. As a rough heuristic — Yoco for low-to-mid volume SA card. Payfast when you need the widest method coverage (Snapscan, Zapper, Mobicred). Peach when fraud risk is real or you need strong intl. card support. Ozow always belongs in the checkout as the instant-EFT option. PayGate / DPO at enterprise scale. We usually wire up 2 gateways per store.
Will I need to do a PCI audit?
Not if we wire it right. Hosted-field / iframe / redirect integrations keep you in PCI SAQ-A — the lightest scope, completed as an annual self-assessment, no auditor needed. We default to SAQ-A for every integration we ship. If you insist on capturing card details on your own form (rare and unwise), the scope jumps to SAQ-A-EP or SAQ-D and requires a real auditor.
What about FNB Pay, Standard Bank, ABSA's own gateways?
SA's "big four" each have direct acquirer gateways. They're typically cheaper at very high volumes but harder to integrate, with rougher developer experience and slower support. We've integrated them — and we'll tell you honestly when it makes sense (usually only at R3M+/mo card volume). For most merchants the SaaS gateways above are the right call.
What's a "merchant of record" and do I need one?
An MoR is the legal entity that sells the goods on record — typically you, the merchant. Some platforms (Paddle, FastSpring, Lemon Squeezy) act as MoR for you, which means they handle tax compliance globally in exchange for higher fees. Useful for SaaS selling worldwide; usually unnecessary for SA-focused e-commerce.
What happens during 3DS — and how does it affect conversion?
3D Secure 2.0 routes the transaction through the customer's issuing bank, which decides whether to challenge them for OTP/biometric. SCA (Strong Customer Authentication) friction is real but tunable — by sending the right risk signals to the gateway (cart amount, customer history, IP, device fingerprint) you can earn frictionless flow for trusted customers. We tune this during integration.
What if a webhook fails permanently?
Our handlers are idempotent + replay-safe, and every integration ships with a reconciliation cron that runs nightly comparing gateway records to your DB. Discrepancies log to Slack and get auto-resolved where possible. For the genuinely-stuck cases, the admin dashboard has a "force-resync this order" button.
How do refunds + chargebacks work?
Refunds: full or partial, triggered from your admin, processed via the gateway API, status reconciled via refund-webhook, customer notified. Chargebacks: gateway notifies us via webhook, the order moves to a "disputed" status, and your team is alerted with the evidence pack (order, customer, IP, 3DS result) needed for the chargeback dispute response.
Can you audit a half-built integration we already have?
Yes — that's actually a big chunk of what we do. We run a 4-hour audit (R1 800) that covers: signature verification, idempotency, refund flow, recon cron, 3DS tuning, PCI scope, security headers, alerting. You get a graded report and a fix-priority list. If you have us do the fixes, the audit fee credits towards the fix work.

Stop losing sales at the payment step.

Send us your current setup (gateway, platform, what's not working) and we'll come back with a 30-minute audit call, a recommended tier, and an indicative price — no obligation.