# Conecte sua conta do Payfast

> Receba por cartão, Instant EFT e Masterpass na África do Sul com sua própria conta do Payfast. Em Configurações > Pagamentos, clique em Configurar Payfast, cole seu Merchant ID, sua Merchant Key e sua Passphrase, escolha Live ou Test, ative e clique em Salvar configurações.

Central de Ajuda / Pagamentos - Atualizado em 19 de novembro de 2026

O Payfast é um provedor de pagamentos para empresas na África do Sul. Quando você conecta sua conta do Payfast, seus clientes podem pagar com cartão, com Instant EFT a partir do próprio banco ou com Masterpass. Os pagamentos vão direto para sua conta do Payfast, e o Shoprocket cobra 0%.

Quando um cliente clica em **Pague agora**, uma janela segura do Payfast abre sobre o seu checkout. Ele paga ali e permanece na sua loja o tempo todo. Os dados do cartão e do banco vão direto para o Payfast e nunca passam pelo Shoprocket.

## Antes de começar

Você precisa de uma conta do Payfast e de três informações do seu painel do Payfast:

1. Seu **Merchant ID** e sua **Merchant Key**, em **Settings > Merchant Details**.
2. Uma **passphrase**. Se ainda não definiu uma, adicione-a em **Settings > Integration**. Escolha algo longo que você não use em nenhum outro lugar. O Payfast usa a passphrase para assinar cada pagamento, então a do Shoprocket precisa ser exatamente igual à do Payfast.

## Conectar o Payfast

1. No seu painel, vá em **Configurações > Pagamentos**.
2. No cartão do Payfast, em **Gateways de pagamento**, clique em **Configurar Payfast**.
3. Cole seu **Merchant ID**, sua **Merchant Key** e sua **Passphrase** nos campos com o mesmo nome.
4. Em **Mode**, escolha **Ao vivo**.
5. Coloque a chave do Payfast em **Ativado** e clique em **Salvar configurações**.

![O cartão do Payfast em Configurações > Pagamentos: os campos de Merchant ID, Merchant Key, Passphrase e modo](https://shoprocket.io/img/help/connect-payfast/payfast-setup.webp)

Ao salvar, o Shoprocket confere seu Merchant ID e sua passphrase com o Payfast. Se o Payfast os recusar, nada é salvo e uma mensagem no topo da tela explica o motivo. O erro mais comum é uma passphrase diferente da que está em **Settings > Integration**, mesmo que seja só por um espaço no final.

O cartão passa a mostrar **Conectado**, e o Payfast aparece no seu checkout.

Não há webhook para configurar. O próprio Shoprocket informa ao Payfast onde avisar cada pagamento. Antes de marcar um pedido como pago, ele confirma esse aviso com o Payfast.

## O Payfast aceita só rand

O Payfast recebe pagamentos em rand sul-africano (ZAR). Depois de salvar, o cartão mostra **Sua conta do Payfast recebe pagamentos em ZAR.**

Se os preços da sua loja estão em outra moeda, o cartão avisa. Nesse caso o Payfast não pode ser seu gateway de cartão principal, mas você ainda pode oferecê-lo a clientes que pagam em rand. Para isso, adicione ZAR em **Gateway de cartão por moeda**, como explica [Escolher um gateway de pagamento](https://shoprocket.io/pt/ajuda/escolher-um-gateway-de-pagamento.md).

## Teste com uma conta sandbox do Payfast

O ambiente de testes do Payfast é uma conta separada. Cadastre-se em sandbox.payfast.co.za. Ela tem Merchant ID, Merchant Key e passphrase próprios.

Para testar seu checkout sem movimentar dinheiro real:

1. Clique em **Editar as credenciais de Payfast**.
2. Cole o Merchant ID, a Merchant Key e a passphrase da sua conta **sandbox**.
3. Em **Mode**, escolha **Test (conta sandbox do Payfast)** e clique em **Salvar configurações**.

O cartão passa a mostrar **Credenciais de teste: nenhum dinheiro real é movimentado**. No modo de teste, **Pague agora** leva o cliente à página de pagamento do sandbox do Payfast em vez de abrir a janela sobre o seu checkout, porque o sandbox do Payfast não oferece essa janela. Pague com um dos cartões de teste do Payfast e você volta para a sua loja com o pedido confirmado.

Quando estiver pronto para vender, clique de novo em **Editar as credenciais de Payfast**, cole os dados da sua conta real do Payfast, escolha **Ao vivo** e clique em **Salvar configurações**.

## Como os clientes pagam

- **Com cartão**: o cliente digita os dados do cartão na janela do Payfast. Se o banco precisar verificar o pagamento, a verificação também abre ali.
- **Com Instant EFT**: o cliente entra no próprio banco na janela do Payfast e aprova o pagamento. O pedido é confirmado assim que o Payfast nos avisa que o dinheiro entrou.
- **Com Masterpass**: o cliente escaneia o código com o aplicativo do banco.

Se um cliente fechar a janela do Payfast sem pagar, ele volta ao carrinho e pode clicar em **Pague agora** para tentar de novo.

## Reembolsos

Quando você reembolsa um pedido pago com o Payfast, o Shoprocket envia o reembolso ao Payfast, total ou parcial. Veja [Reembolsar um pedido](https://shoprocket.io/pt/ajuda/reembolsar-um-pedido.md).

O Payfast só permite reembolsar pelo Shoprocket quando sua conta do Payfast tem acesso à API. Se não tiver, o primeiro reembolso aparece como falho e informa isso. Reembolse o cliente no seu painel do Payfast e depois reembolse o pedido de novo no Shoprocket. O Shoprocket então pede que você confirme que enviou o dinheiro por conta própria e registra o reembolso no pedido. Pedidos pagos no modo de teste são sempre reembolsados assim, porque o sandbox do Payfast não tem reembolsos.

Os reembolsos saem do seu saldo no Payfast, então mantenha o suficiente para cobri-los.

## Assinaturas

O Payfast ainda não consegue renovar assinaturas no Shoprocket. Se você vende assinaturas, mantenha outro gateway de cartão que as renove, como o Stripe ou o Paystack, para esses produtos.

## Alterar as credenciais ou desativar

Depois que o Payfast está conectado, o botão dele passa a se chamar **Editar as credenciais de Payfast**. Suas credenciais salvas ficam armazenadas criptografadas e nunca são exibidas de novo. Para mantê-las, deixe os campos em branco. Para substituí-las, preencha os quatro campos e clique em **Salvar configurações**.

Para parar de oferecer o Payfast, coloque a chave dele em **Desativado** e clique em **Salvar configurações**. Suas credenciais continuam salvas, então você pode reativá-lo quando quiser. Os pagamentos que os clientes já tinham iniciado ainda serão concluídos.

## Artigos relacionados

- [Escolher um gateway de pagamento](https://shoprocket.io/pt/ajuda/escolher-um-gateway-de-pagamento.md)
- [Reembolsar um pedido](https://shoprocket.io/pt/ajuda/reembolsar-um-pedido.md)
- [Faça um pedido de teste](https://shoprocket.io/pt/ajuda/fazer-um-pedido-de-teste.md)

[Abrir Pagamentos no seu painel](https://app.shoprocket.io/go/settings/payments)

---

- HTML version: https://shoprocket.io/pt/ajuda/conectar-payfast
- Language: Português (pt)
- 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), [Nederlands](https://shoprocket.io/nl/hulp/payfast-account-koppelen.md), [Polski](https://shoprocket.io/pl/pomoc/polacz-konto-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)
