O que você vai precisar
Antes de iniciar a configuração, tenha em mãos as seguintes credenciais fornecidas pela SafraPay:
- ID SafraPay
- Merchant Token SafraPay
Esses dados são enviados pela SafraPay no momento do credenciamento, podem ser disponibilizados por e-mail ou conferir no seu painel no menu de Gerenciamento > Chaves de Acesso
Instalando o aplicativo SafraPay na wBuy
Acesse o painel administrativo da wBuy, vá no menu lateral, clique em Configurações > Formas de pagamento, clique em Adicionar, pesquise por SafraPay e clique em Instalar.
Configurando as credenciais
Após instalar o aplicativo clique em Status da loja e deixe ativo, em seguida, preencha os campos:
- ID SafraPay: informe o identificador fornecido pela SafraPay.
- Merchant Token SafraPay: informe o token de autenticação da sua conta.
Configurações de pagamento
Cartão de crédito
Defina se o pagamento por cartão estará:
- Permitido: exibe a opção de cartão no checkout.
- Bloqueado: oculta a opção de cartão.
Boleto bancário
Defina se o pagamento via boleto estará:
- Permitido
- Bloqueado
PIX
Defina se o pagamento via PIX estará:
- Permitido
- Bloqueado
Atenção: Confira se no seu contrato com a SafraPay, as modalides de cartão, boleto e pix estão disponíveis antes de confirmar a permissão delas na loja
Configuração de parcelamento
Você só precisará fazer essa configuração caso queira definir manualmente a porcentagem de juros por parcela.
Quantidade de parcelas sem juros
Selecione em quantas parcelas o cliente poderá pagar sem acréscimo.
Exemplo: se configurado como 3x, pagamentos em até 3 parcelas não terão juros.
Quantidade máxima de parcelas
Defina o número máximo de parcelas disponíveis no checkout.
Juros por parcela
Caso o número de parcelas exceda o limite sem juros, você poderá informar a taxa de juros aplicada em cada parcela.
Exemplo:
- Juros em 2x: 1,99%
- Juros em 3x: 1,99%
- Juros em 4x: 1,99%
Valor mínimo por parcela
Define o valor mínimo permitido para cada parcela. Caso o valor do pedido não atinja o valor mínimo configurado por parcela, o sistema limitará automaticamente a quantidade de parcelas disponível ao cliente.
Exemplo: com valor mínimo de R$ 5,00, um pedido de R$ 20,00 poderá ser parcelado em até 4 vezes.
Atenção: as configurações de parcelamento cadastradas na wBuy são utilizadas apenas para exibição das condições de pagamento na página do produto, carrinho e demais áreas da loja. No checkout, o parcelamento exibido será sempre o retornado pela SafraPay com base nas configurações da sua conta.
Estorno automático
Ao cancelar um pedido na wBuy, você pode definir se o valor pago será estornado automaticamente ao cliente, só serão feitos estornos com pedidos nos status: Cancelado, Negado e Devolvido . Opções disponíveis
- Não estornar valor pago ao cancelar um pedido
- Ao cancelar um pedido, fazer o estorno automaticamente do valor para o cliente
Utilize esta opção com cautela. O estorno será solicitado automaticamente à SafraPay no momento do cancelamento do pedido.
Dias de vencimento do boleto
Informe em quantos dias o boleto deverá vencer após a geração.
Exemplo: se configurado como 1, o boleto vencerá no dia seguinte à compra.
A confirmação do pagamento depende do retorno da SafraPay e pode ocorrer em poucos minutos ou levar mais tempo, conforme a modalidade escolhida.
Box de produto, página de produto e carrinho
Você pode escolher quais informações serão exibidas na página do produto:
- Parcelamento do cartão de crédito
- Informações do boleto
- Informações do PIX
Ative as opções desejadas para melhorar a experiência do cliente e destacar as condições de pagamento.
Finalizando a configuração
Após concluir todas as configurações:
- confira se a opção Status na loja está ativa.
- Clique em Gravar.
Recomendamos realizar testes com todas as modalidades habilitadas (cartão, boleto e PIX) para validar o funcionamento completo da integração.
Pronto! O SafraPay estará disponível para seus clientes no checkout da loja.
Observações importantes
- As credenciais devem ser fornecidas diretamente pela SafraPay.
- Caso alguma forma de pagamento não esteja habilitada, verifique se ela está liberada em seu contrato com a SafraPay.
- Recomendamos realizar um pedido de teste após a configuração para validar o funcionamento da integração.
Ambiente de homoloagção
A SafraPay oferece pela API um ambiente de testes, onde equanto está criando a loja pode fazer testes de compras e validar a integração, para isso solicite as credenciais para tal.
Importante: utilize sempre as credenciais do ambiente de produção para que os pagamentos sejam processados corretamente em sua loja.
Erros comuns
Credenciais inválidas
Se ocorrer erro de autenticação, confira se o ID SafraPay e o Merchant Token SafraPay foram informados corretamente, sem espaços extras no início ou no fim.
Forma de pagamento não aparece no checkout
Verifique se:
- O Status na loja está ativo.
- A modalidade (cartão, boleto ou PIX) está configurada como Permitido.
- A modalidade está habilitada em seu contrato com a SafraPay.
- Chave correta para Ambiente de produção (Live)
Estorno automático não foi realizado
O estorno automático só é executado quando o pedido é alterado para os status:
- Cancelado
- Negado
- Devolvido