PayFast

Integração com o PayFast

O PayFast é um gateway de pagamento da África do Sul. O plugin do Post Affiliate Pro o conecta ao seu programa de afiliado . Após cada pagamento, o PayFast envia uma Notificação Instantânea de Transação (ITN) para a sua instalação do Post Affiliate Pro, e o plugin registra a venda para o afiliado que indicou o cliente. Quando o pagamento pertence a uma assinatura do PayFast, o plugin registra um pagamento recorrente.

Como integrar o Post Affiliate Pro com o PayFast

Ativação do plugin

No seu painel do comerciante, vá em Configurações > Plugins > Processamento de ITN do PayFast > Ativar. Após a ativação, configure o plugin pelo menos com o seguinte:

• Campo de string personalizada: o campo personalizado do PayFast (de custom_str1 a custom_str5) que carrega o valor de rastreamento do seu formulário de pagamento. O padrão é custom_str1. Todas as outras opções são descritas na seção sobre configurações do plugin, abaixo.
• Frase secreta de assinatura: use a mesma frase secreta que você usa na seção Configurações do seu painel do PayFast. O PayFast exige que a frase secreta da sua conta e a do seu site sejam idênticas.

Integração do formulário de pagamento

Para rastrear o afiliado que indicou o cliente, o formulário de pagamento precisa passar o valor de rastreamento ao PayFast, e o PayFast precisa enviar a notificação ao Post Affiliate Pro. Adicione estas partes ao seu formulário de pagamento do PayFast:

<input type="hidden" name="custom_str1" value="" id="pap_dx8vc2s5" />
<input type="hidden" name="notify_url" value="https://URL_TO_PostAffiliatePro/plugins/PayFast/payfast.php" />
<script id="pap_x2s6df8d" src="https://URL_TO_PostAffiliatePro/scripts/notifysale.php" type="text/javascript">
</script>

Lembre-se: se você já usa custom_str1 para outra coisa, use outra string personalizada e selecione a mesma na configuração do plugin.

Observação: Se houver mais de um formulário de pagamento em uma página, você pode colocar a parte <script> apenas uma vez por página inteira. Cada formulário de pagamento precisa apenas das partes <input>.

Exemplo

Veja um exemplo de formulário de pagamento com o código de integração adicionado:

<form action="https://www.payfast.co.za/eng/process" method="post">
  <input type="hidden" name="merchant_id" value="YOUR_MERCHANT_ID" />
  <input type="hidden" name="merchant_key" value="YOUR_MERCHANT_KEY" />
  <input type="hidden" name="amount" value="100.00" />
  <input type="hidden" name="item_name" value="Product 1" />

<input type="hidden" name="custom_str1" value="" id="pap_dx8vc2s5" />
<input type="hidden" name="notify_url" value="https://URL_TO_PostAffiliatePro/plugins/PayFast/payfast.php" />
<script id="pap_x2s6df8d" src="https://URL_TO_PostAffiliatePro/scripts/notifysale.php" type="text/javascript">
</script>

  <input type="submit" value="Pay now" />
</form>

Não se esqueça de integrar o seu site ao código de rastreamento de cliques .

Assinaturas

Para as assinaturas do PayFast, o PayFast envia uma notificação para cada pagamento junto com um token de assinatura. O plugin reconhece o token e registra o pagamento como um pagamento recorrente, usando o token como ID do pedido. Para que isso funcione no PayFast, você precisa ter uma frase secreta definida e a cobrança recorrente ativada na sua conta do PayFast. Para ver como as comissões recorrentes são configuradas do lado do Post Affiliate Pro, leia sobre comissões recorrentes .

Configurações do plugin

O plugin tem as seguintes opções:

• Campo de string personalizada: o campo personalizado do PayFast que carrega o valor de rastreamento. Padrão: custom_str1.
• Frase secreta de assinatura: a frase secreta do seu painel do PayFast.
• Usar ID de pedido do PayFast: por padrão, o plugin usa o ID de pagamento único definido pelo seu sistema (m_payment_id) como ID do pedido. Marque esta opção para usar o ID de pagamento do PayFast.
• Descontar taxa: ativada por padrão. A comissão é calculada a partir do valor líquido, após a taxa do PayFast. Desative para usar o valor bruto.
• Registrar novo afiliado a cada evento ocorrido: cria um novo afiliado a partir do nome e do e-mail do cliente no pagamento.
• Registrar afiliado na compra destes produtos: limita o registro acima a produtos específicos. Deixe em branco para registrar um afiliado em toda compra, ou insira nomes de produtos separados por ponto e vírgula, por exemplo produto1;produto perfeito;produto3. O nome do produto é o nome do item enviado ao PayFast.
• Aprovar afiliado após pagamento bem-sucedido: um afiliado pendente cujo e-mail corresponda ao do cliente que pagou é aprovado após um pagamento bem-sucedido.
• Usar custo total recorrente da notificação: para comissões recorrentes, usa o valor de cada notificação do PayFast em vez do valor do pagamento inicial.
• Dados extras 1 a 5: salva um detalhe da notificação nos campos de dados extras da venda. Você pode escolher o e-mail, o telefone, o nome, o primeiro nome ou o sobrenome do cliente, o nome do item, a descrição do item ou o ID da transação do PayFast. Por padrão, Dados extras 1 é definido como o e-mail do cliente.
• Reenviar IPN para URL: encaminha a notificação do PayFast para outro endereço, por exemplo outro sistema que também usa o ITN. O endereço precisa ser uma URL válida, com o protocolo, e não pode apontar para a mesma instalação do Post Affiliate Pro.

Como o plugin funciona exatamente?

Quando o PayFast envia uma notificação ao endereço do plugin, o plugin:

1. Lê o pagamento: o valor, o ID do pagamento, o e-mail e o nome do cliente, o nome do item e o valor de rastreamento do seu campo de string personalizada.
2. Verifica o status do pagamento. Somente o status COMPLETE é processado; qualquer outro status é ignorado.
3. Encontra o afiliado a partir do valor de rastreamento e, se estiver ativado, registra um novo afiliado ou aprova um pendente.
4. Registra a comissão. Se a notificação contiver um token de assinatura, ela é registrada como pagamento recorrente; caso contrário, como venda comum.

Comissões vitalícias

Se você usa comissões vitalícias , o plugin precisa de um detalhe que identifique o cliente entre os pagamentos. Quando o plugin Comissões Vitalícias está ativo, defina o campo de dados extras que ele usa como o e-mail ou o telefone do cliente. Se você escolher outra coisa, as configurações do plugin mostrarão um erro para esse campo.

O que é o PayFast?

O PayFast é um gateway de pagamento com sede na África do Sul, fundado em 2007. Faz parte da Network International e afirma ser confiável por mais de 80.000 empresas sul-africanas. Ele permite que lojas online aceitem pagamentos de clientes sem precisar construir o próprio processamento de pagamentos.

Para programas de afiliados, isso o torna uma escolha natural quando seus clientes ou seus afiliados estão na África do Sul, porque os clientes pagam com os métodos que já usam, e cada venda ainda pode ser rastreada até o afiliado que a indicou.

Principais recursos do PayFast

• Muitos métodos de pagamento: mais de 18 métodos, incluindo cartões de crédito, Instant EFT, códigos QR, Mobicred e cartões de loja.
• Assinaturas: cobrança recorrente para associações e produtos por assinatura.
• Tokenização e pagamentos divididos: armazene dados de pagamento com segurança e divida um pagamento entre as partes.
• Reembolsos e faturamento: reembolsos e faturas do comerciante a partir da sua conta do PayFast.
• Integrações: conecta-se a mais de 70 plataformas existentes e tem uma API para desenvolvedores.
• Notificação Instantânea de Transação: uma notificação para cada pagamento, que é como as vendas chegam ao Post Affiliate Pro.

Preços do PayFast

O PayFast afirma que sua solução de agregação não tem mensalidade e que você paga apenas uma pequena taxa de transação quando faz uma venda. As taxas exatas dependem do método de pagamento, então verifique-as no site do PayFast antes de decidir. As taxas mudam, então use os valores atuais do PayFast.

Alternativas ao PayFast

Se o PayFast não se encaixar no seu negócio, estes são gateways de pagamento usados na África do Sul:

• Ozow
• Peach Payments
• Yoco
• Netcash

Outras integrações de gateways de pagamento

O Post Affiliate Pro também integra com muitos outros gateways de pagamento. Veja os guias de Stripe , PayPal , Worldpay , ou navegue por todas as integrações .