# Je Payfast-account koppelen

> Ontvang betalingen met kaart, Instant EFT en Masterpass in Zuid-Afrika met je eigen Payfast-account. Klik onder Instellingen > Betalingen op Payfast instellen, plak je Merchant ID, Merchant Key en Passphrase, kies Live of Test, zet het aan en klik op Instellingen opslaan.

Helpcentrum / Betalingen - Bijgewerkt op 19 november 2026

Payfast is een betaalprovider voor bedrijven in Zuid-Afrika. Als je je Payfast-account koppelt, kunnen je klanten betalen met een kaart, met Instant EFT vanaf hun eigen bank of met Masterpass. Betalingen gaan rechtstreeks naar je Payfast-account, en Shoprocket rekent 0%.

Als een klant op **Nu betalen** klikt, opent er een beveiligd Payfast-venster boven je checkout. De klant betaalt daar en blijft de hele tijd in je winkel. Kaart- en bankgegevens gaan rechtstreeks naar Payfast en lopen nooit via Shoprocket.

## Voordat je begint

Je hebt een Payfast-account nodig en drie gegevens uit je Payfast-dashboard:

1. Je **Merchant ID** en **Merchant Key**, onder **Settings > Merchant Details**.
2. Een **wachtzin** (passphrase). Heb je er nog geen ingesteld, voeg die dan toe onder **Settings > Integration**. Kies iets langs dat je nergens anders gebruikt. Payfast gebruikt de wachtzin om elke betaling te ondertekenen, dus de wachtzin in Shoprocket moet precies overeenkomen met die in Payfast.

## Payfast koppelen

1. Ga in je dashboard naar **Instellingen > Betalingen**.
2. Klik op de Payfast-kaart onder **Betaalgateways** op **Payfast instellen**.
3. Plak je **Merchant ID**, **Merchant Key** en **Passphrase** in de velden met dezelfde naam.
4. Kies onder **Mode** de optie **Live**.
5. Zet de schakelaar van Payfast op **Aan** en klik op **Instellingen opslaan**.

![De Payfast-kaart in Instellingen > Betalingen: de velden voor Merchant ID, Merchant Key, Passphrase en modus](https://shoprocket.io/img/help/connect-payfast/payfast-setup.webp)

Bij het opslaan controleert Shoprocket je Merchant ID en wachtzin bij Payfast. Als Payfast ze weigert, wordt er niets opgeslagen en legt een melding bovenaan het scherm uit waarom. De meest gemaakte fout is een wachtzin die afwijkt van die onder **Settings > Integration**, al is het maar door een spatie aan het eind.

De kaart toont dan **Gekoppeld**, en Payfast verschijnt in je checkout.

Je hoeft geen webhook in te stellen. Shoprocket vertelt Payfast zelf waar elke betaling gemeld moet worden. Voordat een bestelling als betaald wordt gemarkeerd, controleert Shoprocket die melding bij Payfast.

## Payfast accepteert alleen rand

Payfast accepteert betalingen in Zuid-Afrikaanse rand (ZAR). Zodra je opslaat, toont de kaart **Je Payfast-account ontvangt betalingen in ZAR.**

Als de prijzen in je winkel in een andere valuta staan, waarschuwt de kaart je. Payfast kan dan niet je belangrijkste kaartgateway zijn, maar je kunt het nog wel aanbieden aan klanten die in rand betalen. Voeg daarvoor ZAR toe onder **Kaartgateway per valuta**, zoals uitgelegd in [Een betaalgateway kiezen](https://shoprocket.io/nl/hulp/een-betaalgateway-kiezen.md).

## Uitproberen met een Payfast-sandboxaccount

De testomgeving van Payfast is een apart account. Meld je aan op sandbox.payfast.co.za. Het heeft een eigen Merchant ID, Merchant Key en wachtzin.

Zo probeer je je checkout uit zonder echt geld te verplaatsen:

1. Klik op **Inloggegevens van Payfast bewerken**.
2. Plak het Merchant ID, de Merchant Key en de wachtzin van je **sandbox**-account.
3. Kies onder **Mode** de optie **Test (Payfast-sandboxaccount)** en klik op **Instellingen opslaan**.

De kaart toont dan **Testgegevens: er gaat geen echt geld heen en weer**. In de testmodus brengt **Nu betalen** de klant naar de sandbox-betaalpagina van Payfast in plaats van het venster boven je checkout te openen, omdat de sandbox van Payfast dat venster niet biedt. Betaal met een van de testkaarten van Payfast, en je komt terug in je winkel met een bevestigde bestelling.

Als je klaar bent om te verkopen, klik je opnieuw op **Inloggegevens van Payfast bewerken**, plak je de gegevens van je echte Payfast-account, kies je **Live** en klik je op **Instellingen opslaan**.

## Hoe klanten betalen

- **Met een kaart**: de klant typt zijn kaartgegevens in het Payfast-venster. Als zijn bank de betaling moet controleren, opent die controle daar ook.
- **Met Instant EFT**: de klant logt in het Payfast-venster in bij zijn eigen bank en keurt de betaling goed. De bestelling wordt bevestigd zodra Payfast ons meldt dat het geld binnen is.
- **Met Masterpass**: de klant scant de code met zijn bankapp.

Als een klant het Payfast-venster sluit zonder te betalen, is hij terug in zijn winkelwagen en kan hij opnieuw op **Nu betalen** klikken om het nog eens te proberen.

## Terugbetalingen

Als je een bestelling terugbetaalt die met Payfast is betaald, stuurt Shoprocket de terugbetaling naar Payfast, geheel of gedeeltelijk. Zie [Een bestelling terugbetalen](https://shoprocket.io/nl/hulp/een-bestelling-terugbetalen.md).

Payfast staat terugbetalingen via Shoprocket alleen toe als je Payfast-account API-toegang heeft. Zo niet, dan toont de eerste terugbetaling als mislukt en staat dat erbij. Betaal de klant dan terug in je Payfast-dashboard en betaal de bestelling daarna nogmaals terug in Shoprocket. Shoprocket vraagt je dan te bevestigen dat je het geld zelf hebt overgemaakt, en legt de terugbetaling vast bij de bestelling. Bestellingen die in de testmodus zijn betaald, worden altijd zo terugbetaald, omdat de sandbox van Payfast geen terugbetalingen kent.

Terugbetalingen worden van je Payfast-saldo afgeschreven, zorg dus dat daar genoeg op staat.

## Abonnementen

Payfast kan abonnementen in Shoprocket nog niet verlengen. Verkoop je abonnementen, houd dan voor die producten een andere kaartgateway aan die ze wel verlengt, zoals Stripe of Paystack.

## Je inloggegevens wijzigen of uitzetten

Zodra Payfast gekoppeld is, heet de knop **Inloggegevens van Payfast bewerken**. Je opgeslagen inloggegevens staan versleuteld opgeslagen en worden nooit meer getoond. Laat de velden leeg om ze te behouden. Vul alle vier de velden in en klik op **Instellingen opslaan** om ze te vervangen.

Om Payfast niet meer aan te bieden, zet je de schakelaar op **Uit** en klik je op **Instellingen opslaan**. Je inloggegevens blijven bewaard, zodat je het op elk moment weer kunt aanzetten. Betalingen die klanten al zijn gestart, worden nog gewoon afgerond.

## Gerelateerd

- [Een betaalgateway kiezen](https://shoprocket.io/nl/hulp/een-betaalgateway-kiezen.md)
- [Een bestelling terugbetalen](https://shoprocket.io/nl/hulp/een-bestelling-terugbetalen.md)
- [Een testbestelling plaatsen](https://shoprocket.io/nl/hulp/een-testbestelling-plaatsen.md)

[Betalingen openen in je dashboard](https://app.shoprocket.io/go/settings/payments)

---

- HTML version: https://shoprocket.io/nl/hulp/payfast-account-koppelen
- Language: Nederlands (nl)
- Also in: [العربية](https://shoprocket.io/ar/help/connect-payfast.md), [Deutsch](https://shoprocket.io/de/hilfe/payfast-konto-verbinden.md), [Ελληνικά](https://shoprocket.io/el/help/connect-payfast.md), [English](https://shoprocket.io/help/connect-payfast.md), [Español](https://shoprocket.io/es/ayuda/conectar-payfast.md), [Français](https://shoprocket.io/fr/aide/connecter-payfast.md), [עברית](https://shoprocket.io/he/help/connect-payfast.md), [हिन्दी](https://shoprocket.io/hi/help/connect-payfast.md), [Bahasa Indonesia](https://shoprocket.io/id/bantuan/hubungkan-akun-payfast.md), [Italiano](https://shoprocket.io/it/aiuto/collega-payfast.md), [日本語](https://shoprocket.io/ja/help/connect-payfast.md), [Lietuvių](https://shoprocket.io/lt/pagalba/prijunkite-payfast-paskyra.md), [Norsk](https://shoprocket.io/nb/hjelp/koble-til-payfast-kontoen-din.md), [Polski](https://shoprocket.io/pl/pomoc/polacz-konto-payfast.md), [Português](https://shoprocket.io/pt/ajuda/conectar-payfast.md), [Română](https://shoprocket.io/ro/ajutor/conecteaza-contul-payfast.md), [Русский](https://shoprocket.io/ru/help/connect-payfast.md), [ไทย](https://shoprocket.io/th/help/connect-payfast.md), [Türkçe](https://shoprocket.io/tr/yardim/payfast-hesabi-baglama.md), [中文](https://shoprocket.io/zh/help/connect-payfast.md)
