# Collega il tuo account Payfast

> Incassa con carte, Instant EFT e Masterpass in Sudafrica con il tuo account Payfast. In Impostazioni > Pagamenti, clicca su Configura Payfast, incolla il tuo Merchant ID, la tua Merchant Key e la tua Passphrase, scegli Live o Test, attivalo e clicca su Salva impostazioni.

Centro assistenza / Pagamenti - Aggiornato il 19 novembre 2026

Payfast è un fornitore di pagamenti per le aziende del Sudafrica. Quando colleghi il tuo account Payfast, i tuoi clienti possono pagare con carta, con Instant EFT dalla propria banca o con Masterpass. I pagamenti vanno direttamente sul tuo account Payfast e Shoprocket prende lo 0 %.

Quando un cliente clicca su **Paga ora**, sopra il tuo checkout si apre una finestra sicura di Payfast. Paga lì e resta nel tuo negozio per tutto il tempo. I dati della carta e della banca vanno direttamente a Payfast e non passano mai da Shoprocket.

## Prima di iniziare

Ti servono un account Payfast e tre dati dalla tua dashboard Payfast:

1. Il tuo **Merchant ID** e la tua **Merchant Key**, in **Settings > Merchant Details**.
2. Una **passphrase**. Se non ne hai ancora impostata una, aggiungila in **Settings > Integration**. Scegli qualcosa di lungo che non usi da nessun'altra parte. Payfast la usa per firmare ogni pagamento, quindi la passphrase in Shoprocket deve coincidere esattamente con quella in Payfast.

## Collegare Payfast

1. Nella tua dashboard, vai in **Impostazioni > Pagamenti**.
2. Sulla scheda Payfast in **Gateway di pagamento**, clicca su **Configura Payfast**.
3. Incolla il tuo **Merchant ID**, la tua **Merchant Key** e la tua **Passphrase** nei campi con lo stesso nome.
4. Sotto **Mode**, scegli **Live**.
5. Porta l'interruttore di Payfast su **Attivo** e clicca su **Salva impostazioni**.

![La scheda Payfast in Impostazioni > Pagamenti: i campi per Merchant ID, Merchant Key, Passphrase e modalità](https://shoprocket.io/img/help/connect-payfast/payfast-setup.webp)

Quando salvi, Shoprocket verifica il tuo Merchant ID e la tua passphrase con Payfast. Se Payfast li rifiuta, non viene salvato nulla e un messaggio in alto sullo schermo ne spiega il motivo. L'errore più comune è una passphrase diversa da quella in **Settings > Integration**, anche solo per uno spazio alla fine.

La scheda mostra poi **Collegato**, e Payfast compare nel tuo checkout.

Non c'è nessun webhook da configurare. È Shoprocket a dire a Payfast dove segnalare ogni pagamento. Prima di segnare un ordine come pagato, controlla quella segnalazione con Payfast.

## Payfast accetta solo rand

Payfast incassa in rand sudafricani (ZAR). Una volta salvato, la scheda mostra **Il tuo account Payfast incassa in ZAR.**

Se i prezzi del tuo negozio sono in un'altra valuta, la scheda ti avvisa. In quel caso Payfast non può essere il tuo gateway principale per le carte, ma puoi comunque offrirlo ai clienti che pagano in rand. Per farlo, aggiungi ZAR sotto **Gateway carte per valuta**, come spiega [Scegliere un gateway di pagamento](https://shoprocket.io/it/aiuto/scegliere-un-gateway-di-pagamento.md).

## Provalo con un account sandbox Payfast

L'ambiente di test di Payfast è un account separato. Registrati su sandbox.payfast.co.za. Ha il suo Merchant ID, la sua Merchant Key e la sua passphrase.

Per provare il tuo checkout senza muovere denaro reale:

1. Clicca su **Modifica le credenziali di Payfast**.
2. Incolla il Merchant ID, la Merchant Key e la passphrase del tuo account **sandbox**.
3. Sotto **Mode**, scegli **Test (account sandbox Payfast)** e clicca su **Salva impostazioni**.

La scheda mostra poi **Credenziali di test: nessun denaro reale si muove**. In modalità di test, **Paga ora** porta il cliente alla pagina di pagamento sandbox di Payfast invece di aprire la finestra sopra il tuo checkout, perché la sandbox di Payfast non offre quella finestra. Paga con una delle carte di test di Payfast e torni nel tuo negozio con l'ordine confermato.

Quando sei pronto a vendere, clicca di nuovo su **Modifica le credenziali di Payfast**, incolla i dati del tuo account Payfast reale, scegli **Live** e clicca su **Salva impostazioni**.

## Come pagano i tuoi clienti

- **Con carta**: il cliente inserisce i dati della carta nella finestra di Payfast. Se la sua banca deve verificare il pagamento, la verifica si apre anche lì.
- **Con Instant EFT**: il cliente accede alla propria banca nella finestra di Payfast e approva il pagamento. L'ordine viene confermato non appena Payfast ci comunica che il denaro è arrivato.
- **Con Masterpass**: il cliente scansiona il codice con la sua app bancaria.

Se un cliente chiude la finestra di Payfast senza pagare, torna al carrello e può cliccare di nuovo su **Paga ora** per riprovare.

## Rimborsi

Quando rimborsi un ordine pagato con Payfast, Shoprocket invia il rimborso a Payfast, totale o parziale. Vedi [Rimborsa un ordine](https://shoprocket.io/it/aiuto/rimborsare-un-ordine.md).

Payfast permette di rimborsare tramite Shoprocket solo se il tuo account Payfast ha accesso API. In caso contrario, il primo rimborso risulta fallito e lo dice. Rimborsa il cliente nella tua dashboard Payfast, poi rimborsa di nuovo l'ordine in Shoprocket. A quel punto Shoprocket ti chiede di confermare di aver inviato tu stesso il denaro e registra il rimborso sull'ordine. Gli ordini pagati in modalità di test si rimborsano sempre così, perché la sandbox di Payfast non prevede rimborsi.

I rimborsi vengono prelevati dal tuo saldo Payfast, quindi assicurati che sia sufficiente a coprirli.

## Abbonamenti

Payfast non può ancora rinnovare gli abbonamenti su Shoprocket. Se vendi abbonamenti, tieni un altro gateway per le carte che li rinnovi, come Stripe o Paystack, per quei prodotti.

## Cambiare le credenziali o disattivarlo

Dopo aver collegato Payfast, il suo pulsante diventa **Modifica le credenziali di Payfast**. Le credenziali salvate sono conservate cifrate e non vengono più mostrate. Per tenerle, lascia i campi vuoti. Per sostituirle, compila tutti e quattro i campi e clicca su **Salva impostazioni**.

Per smettere di offrire Payfast, porta il suo interruttore su **Disattivo** e clicca su **Salva impostazioni**. Le tue credenziali restano salvate, quindi puoi riattivarlo quando vuoi. I pagamenti che i clienti avevano già avviato andranno comunque a buon fine.

## Articoli correlati

- [Scegliere un gateway di pagamento](https://shoprocket.io/it/aiuto/scegliere-un-gateway-di-pagamento.md)
- [Rimborsa un ordine](https://shoprocket.io/it/aiuto/rimborsare-un-ordine.md)
- [Effettua un ordine di test](https://shoprocket.io/it/aiuto/effettuare-un-ordine-di-test.md)

[Apri Pagamenti nella tua dashboard](https://app.shoprocket.io/go/settings/payments)

---

- HTML version: https://shoprocket.io/it/aiuto/collega-payfast
- Language: Italiano (it)
- 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), [日本語](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)
