# Connecter votre compte Payfast

> Encaissez par carte, Instant EFT et Masterpass en Afrique du Sud avec votre propre compte Payfast. Dans Paramètres > Paiements, cliquez sur Configurer Payfast, collez votre Merchant ID, votre Merchant Key et votre Passphrase, choisissez Live ou Test, activez-le et cliquez sur Enregistrer les paramètres.

Centre d’aide / Paiements - Mis à jour le 19 novembre 2026

Payfast est un prestataire de paiement pour les entreprises d'Afrique du Sud. Quand vous connectez votre compte Payfast, vos clients peuvent payer par carte, par Instant EFT depuis leur propre banque, ou avec Masterpass. Les paiements arrivent directement sur votre compte Payfast, et Shoprocket prend 0 %.

Quand un client clique sur **Payer maintenant**, une fenêtre Payfast sécurisée s'ouvre au-dessus de votre paiement. Il y paie et reste dans votre boutique pendant tout le processus. Les informations de carte et de banque vont directement à Payfast et ne passent jamais par Shoprocket.

## Avant de commencer

Vous avez besoin d'un compte Payfast et de trois informations de votre tableau de bord Payfast :

1. Votre **Merchant ID** et votre **Merchant Key**, dans **Settings > Merchant Details**.
2. Une **passphrase**. Si vous n'en avez pas encore définie, ajoutez-la dans **Settings > Integration**. Choisissez quelque chose de long que vous n'utilisez nulle part ailleurs. Payfast s'en sert pour signer chaque paiement, la passphrase dans Shoprocket doit donc correspondre exactement à celle de Payfast.

## Connecter Payfast

1. Dans votre tableau de bord, allez dans **Paramètres > Paiements**.
2. Sur la carte Payfast dans **Passerelles de paiement**, cliquez sur **Configurer Payfast**.
3. Collez votre **Merchant ID**, votre **Merchant Key** et votre **Passphrase** dans les champs du même nom.
4. Sous **Mode**, choisissez **En direct**.
5. Mettez l'interrupteur de Payfast sur **Activé** et cliquez sur **Enregistrer les paramètres**.

![La carte Payfast dans Paramètres > Paiements : les champs Merchant ID, Merchant Key, Passphrase et mode](https://shoprocket.io/img/help/connect-payfast/payfast-setup.webp)

À l'enregistrement, Shoprocket vérifie votre Merchant ID et votre passphrase auprès de Payfast. Si Payfast les refuse, rien n'est enregistré et un message en haut de l'écran en donne la raison. L'erreur la plus fréquente est une passphrase différente de celle de **Settings > Integration**, ne serait-ce que par une espace à la fin.

La carte affiche alors **Connecté**, et Payfast apparaît dans votre paiement.

Il n'y a aucun webhook à configurer. Shoprocket indique lui-même à Payfast où signaler chaque paiement. Avant de marquer une commande comme payée, il vérifie ce signalement auprès de Payfast.

## Payfast n'accepte que le rand

Payfast encaisse en rand sud-africain (ZAR). La carte affiche **Votre compte Payfast encaisse en ZAR.** une fois que vous avez enregistré.

Si les prix de votre boutique sont dans une autre devise, la carte vous avertit. Payfast ne peut alors pas être votre passerelle de carte principale, mais vous pouvez quand même le proposer aux clients qui paient en rand. Pour cela, ajoutez ZAR sous **Passerelle de carte par devise**, comme l'explique [Choisir une passerelle de paiement](https://shoprocket.io/fr/aide/choisir-une-passerelle-de-paiement.md).

## L'essayer avec un compte sandbox Payfast

L'environnement de test de Payfast est un compte distinct. Créez-en un sur sandbox.payfast.co.za. Il a son propre Merchant ID, sa propre Merchant Key et sa propre passphrase.

Pour essayer votre paiement sans déplacer d'argent réel :

1. Cliquez sur **Modifier les identifiants Payfast**.
2. Collez le Merchant ID, la Merchant Key et la passphrase de votre compte **sandbox**.
3. Sous **Mode**, choisissez **Test (compte sandbox Payfast)** et cliquez sur **Enregistrer les paramètres**.

La carte affiche alors **Identifiants de test : aucun argent réel n'est déplacé**. En mode test, **Payer maintenant** envoie le client sur la page de paiement sandbox de Payfast au lieu d'ouvrir la fenêtre au-dessus de votre paiement, car le sandbox de Payfast ne propose pas cette fenêtre. Payez avec l'une des cartes de test de Payfast, et vous revenez dans votre boutique avec la commande confirmée.

Quand vous êtes prêt à vendre, cliquez à nouveau sur **Modifier les identifiants Payfast**, collez les informations de votre compte Payfast réel, choisissez **En direct** et cliquez sur **Enregistrer les paramètres**.

## Comment vos clients paient

- **Par carte** : le client saisit les informations de sa carte dans la fenêtre Payfast. Si sa banque doit vérifier le paiement, la vérification s'ouvre là aussi.
- **Par Instant EFT** : le client se connecte à sa propre banque dans la fenêtre Payfast et approuve le paiement. La commande est confirmée dès que Payfast nous indique que l'argent est arrivé.
- **Avec Masterpass** : le client scanne le code avec l'application de sa banque.

Si un client ferme la fenêtre Payfast sans payer, il retrouve son panier et peut cliquer sur **Payer maintenant** pour réessayer.

## Remboursements

Quand vous remboursez une commande payée avec Payfast, Shoprocket envoie le remboursement à Payfast, en totalité ou en partie. Voir [Rembourser une commande](https://shoprocket.io/fr/aide/rembourser-une-commande.md).

Payfast ne permet de rembourser via Shoprocket que si votre compte Payfast dispose de l'accès API. Sinon, le premier remboursement s'affiche comme échoué et l'indique. Remboursez alors le client dans votre tableau de bord Payfast, puis remboursez de nouveau la commande dans Shoprocket. Shoprocket vous demande ensuite de confirmer que vous avez envoyé l'argent vous-même, et enregistre le remboursement sur la commande. Les commandes payées en mode test sont toujours remboursées de cette façon, car le sandbox de Payfast ne gère pas les remboursements.

Les remboursements sont prélevés sur votre solde Payfast, veillez donc à ce qu'il soit suffisant pour les couvrir.

## Abonnements

Payfast ne peut pas encore renouveler les abonnements dans Shoprocket. Si vous vendez des abonnements, gardez pour ces produits une autre passerelle de carte qui les renouvelle, comme Stripe ou Paystack.

## Modifier vos identifiants ou le désactiver

Une fois Payfast connecté, son bouton devient **Modifier les identifiants Payfast**. Vos identifiants enregistrés sont stockés chiffrés et ne sont plus jamais affichés. Pour les conserver, laissez les champs vides. Pour les remplacer, remplissez les quatre champs et cliquez sur **Enregistrer les paramètres**.

Pour ne plus proposer Payfast, mettez son interrupteur sur **Désactivé** et cliquez sur **Enregistrer les paramètres**. Vos identifiants restent enregistrés, vous pouvez donc le réactiver à tout moment. Les paiements que vos clients avaient déjà commencés aboutiront quand même.

## Articles liés

- [Choisir une passerelle de paiement](https://shoprocket.io/fr/aide/choisir-une-passerelle-de-paiement.md)
- [Rembourser une commande](https://shoprocket.io/fr/aide/rembourser-une-commande.md)
- [Passer une commande de test](https://shoprocket.io/fr/aide/passer-une-commande-de-test.md)

[Ouvrir Paiements dans votre tableau de bord](https://app.shoprocket.io/go/settings/payments)

---

- HTML version: https://shoprocket.io/fr/aide/connecter-payfast
- Language: Français (fr)
- 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), [עברית](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), [Nederlands](https://shoprocket.io/nl/hulp/payfast-account-koppelen.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)
