Conectores de Pagamento — Como configurar o SafraPay

A configuração do SafraPay é feita no Admin em 3 etapas:

• 1ª etapa: Obtenção das Chaves de Acesso no Portal SafraPay
• 2ª etapa: Formas de Pagamento
• 3ª etapa: Gerenciamento de Pagamento

Confira o passo a passo das configurações dentro das suas respectivas etapas:

Antes de configurar o conector SafraPay no Admin da Wake, é necessário acessar o Portal de Safrapay para obter as chaves de integração. Siga o passo a passo abaixo:

Passo 1 — Acesse o Portal SafraPay

Acesse: portal.safrapay.com.br/login

Passo 2 — Realize o Cadastro (novo usuário)

Caso ainda não possua cadastro, clique no botão "Cadastre-se" no canto superior direito.

Passo 3 — Faça o Login no Portal SafraPay

Acesse: https://portal.safrapay.com.br/login

Insira seu e-mail e senha cadastrados e clique em "Entrar".

Tela de login do Portal SafraPay (portal.safrapay.com.br/login). Logo "Safrapay", campos E-mail e Senha, link "Esqueceu sua senha?" e botão "Entrar" em dourado. À esquerda, imagem de máquina de cartão.

Passo 4 — Autenticação por Código de Verificação (MFA)

Após inserir e-mail e senha, o sistema exibirá um modal solicitando um Código de Verificação de 6 dígitos.

Modal "Código de Verificação" sobreposto à tela de login. Mensagem: "Para realizar esta ação, digite abaixo o código de 6 dígitos que enviamos para o seu e-mail". 6 campos de dígito individuais. Opção "Reenviar código em 00:41".

Acesse seu e-mail cadastrado — você receberá uma mensagem do remetente SafraPay <noreply@safra.com.br> com o código de autenticação.

E-mail recebido do SafraPay com assunto "Segue Código de Verificação!". Corpo: logo SafraPay, saudação ao usuário, "Código de segurança válido por 10 minutos" e código numérico de 6 dígitos em negrito.

Digite o código recebido no e-mail nos campos do modal e confirme para acessar o portal.

Passo 5 — Acesse o Dashboard do Portal SafraPay

Após a autenticação, você será direcionado ao Dashboard do Portal SafraPay.

Dashboard do Portal SafraPay. Menu lateral esquerdo (fundo escuro) com: Transacional, Dashboard, Transações, Link de Pagamento, Faturas, Recorrência, Gerenciamento, Boas práticas. Área principal com métricas: Total transacionado, Pré autorizado, Aprovado, Negado pelo emissor, Negado pelo Antifraude, Cancelado, Ticket médio, gráfico de transações capturadas, Taxa de conversão e Índice de cancelamento.

Passo 6 — Acesse o Menu Gerenciamento > Chaves de Acesso

No menu lateral esquerdo, clique em "Gerenciamento" para expandir o submenu. Em seguida, clique em "Chaves de Acesso".

Menu lateral esquerdo expandido com "Gerenciamento" selecionado. Subitens visíveis: Meus Dados (destacado com borda pontilhada amarela), Chaves de Acesso, Produtos, Clientes, Estabelecimentos, Usuários, Boleto, Loja Virtual. Indicar "Chaves de Acesso" com seta ou destaque na documentação final.

Passo 7 — Confirme a Visualização das Chaves

O sistema exibirá um modal de confirmação: "Deseja visualizar as chaves de acesso?" Clique em "Sim" para prosseguir.

Modal centralizado com título "Chaves de acesso" e a pergunta "Deseja visualizar as chaves de acesso?", com os botões "Não" (em vermelho) e "Sim" (em verde).

Passo 8 — Copie as Chaves de Acesso

Após a confirmação, a tela Gerenciamento / Chaves de Acesso será exibida com as seguintes informações:

Tela "Gerenciamento / Chaves de Acesso". Card superior esquerdo: campo "ID" com ícone de chave e botão "Copiar". Card superior direito: "Código de Ativação" com botão "Copiar". Tabela "Merchant Tokens" com colunas: Merchant Token, Data de criação, Data de expiração, Status (badges Novo/Ativo em verde ou Desativado em vermelho) e Ações (toggle on/off). Valores das chaves ocultados/censurados.

As chaves que devem ser copiadas e enviadas para configurar na Wake são:

No painel administrativo da plataforma Wake acesse o menu Pagamentos >> Conectores de pagamento.

Depois selecione o conector em >> SafraPay - Cartão de Crédito >> "Nova configuração":

Descrição dos campos — CARTÃO de Crédito

Antifraude: não preencher. A Safrapay não é compatível com antifraude rodando dentro de Wake. Se tiver interesse em utilizar, entre em contato com a Safrapay.

Pix

Descrição dos campos — PIX

Após as configurações iniciais, clique em Pagamentos >> Gerenciamento de Pagamentos e siga o passo a passo completo no artigo Grupos e Parcelamentos.

LIMITAÇÕES DO CONECTOR

O conector SafraPay foi homologado na plataforma Wake com os fluxos de Cartão de Crédito e PIX. Os itens abaixo não são compatíveis com esta integração:

• Storefront: o conector é compatível apenas com o Storefront 2.0. Não há suporte para versões anteriores.

• Estorno parcial: não suportado pelo conector. Apenas o estorno total está disponível (via API Pública da Wake).

• Split de pagamento: não é possível utilizar mais de um meio de pagamento no mesmo pedido (ex.: dois cartões, ou cartão + outro meio).

• Assinatura / recorrência: o conector não suporta cobranças recorrentes ou planos de assinatura.

• Salvar cartão / cartões sugeridos: não há suporte para tokenização de cartões para compras futuras (carteira de cartões salvos).

• Troca de meio de pagamento no PIX: não é possível alterar a forma de pagamento de um pedido PIX já gerado. O consumidor deve criar um novo pedido.

• 🧪  Realize pedidos de teste com um cartão válido para verificar se os pagamentos são processados corretamente no SafraPay.
• Faça um pedido teste com PIX SafraPay para verificar se o QR Code será gerado corretamente, caso vá utilizar esta forma de pagamento.
• Faça um pedido teste com Boleto SafraPay para verificar se o boleto será gerado corretamente, caso vá utilizar esta forma de pagamento.
• 🔑  Merchant Token: utilize sempre o token com status "Ativo". Caso expire ou seja desativado, acesse o Portal SafraPay e gere um novo token antes de atualizar nas configurações da Wake.
• ↩️  Cancelamento/Estorno: a opção de cancelamento do pedido está disponível na API Pública da Wake, assim como o estorno total ou parcial.
• 📞  Em caso de dúvidas, contate o suporte SafraPay: suporte.ecommerce@safra.com.br | 0800 772 5755