Para conectar a Appmax, você inicia a configuração na Fliper, acessa a Appmax para autorizar o aplicativo e retorna ao painel. Depois, confira a conexão e teste os meios de pagamento disponíveis para sua loja.
Antes de começar
- Tenha sua conta e loja cadastradas na Fliper.
- Tenha acesso à conta Appmax que receberá os pagamentos da operação e permissão para autorizar a integração.
- Confira se a loja está usando ambiente de teste ou produção. Se a autorização apresentar Sandbox, você está configurando o ambiente de testes.
- Para testar o checkout completo, prepare o catálogo da Shopify e, para produtos físicos, o frete com a Frenet.
Atenção: uma conexão em sandbox não habilita recebimentos reais. A conexão e os meios de pagamento precisam estar liberados no ambiente de produção antes de abrir a operação aos compradores.
Passo 1 — Inicie a conexão na Fliper
- Acesse Configuração no painel Fliper.
- Localize o card Appmax no grupo de pagamento e clique em Configurar.
- Leia a identificação do ambiente e clique em Conectar Appmax.
- Aguarde o navegador abrir a página de autorização da Appmax.
Resultado esperado: você chega à autorização iniciada pela sua loja Fliper. Comece pelo botão do painel sempre que precisar iniciar uma nova tentativa.
Passo 2 — Autorize sua conta na Appmax
- Entre na conta Appmax correspondente à sua operação e ao ambiente utilizado.
- Confira a identificação do aplicativo e os dados da loja apresentados na autorização.
- Conclua as informações que a Appmax solicitar e autorize a instalação.
- Aguarde o retorno ao painel Fliper. Evite fechar a aba antes dessa conclusão.
O retorno faz parte do fluxo oficial de autorização da Appmax. A Fliper recebe o resultado e registra a conexão da loja.
Dica: você não precisa criar um aplicativo na Appmax ou copiar credenciais técnicas para a Fliper. Se sua versão do painel mostrar Callback Appmax ou Health check, esses endereços pertencem à configuração técnica da plataforma e não são campos que o lojista deve preencher.
Passo 3 — Confira o retorno na Fliper
- Depois do retorno, abra Configuração → Appmax → Configurar.
- Confira se o Status da conexão mostra Conectado.
- Se aparecer uma falha, leia a mensagem antes de tentar novamente. Se a autorização foi cancelada ou expirou, inicie uma nova tentativa em Conectar Appmax.
- Se a autorização foi concluída na Appmax, mas a conexão continuar pendente, confira a situação da instalação antes de repetir o processo.
Resultado esperado: a integração aparece conectada à conta escolhida. Esse estado confirma a configuração; o teste de pagamento confirma o funcionamento operacional.
Passo 4 — Confira os meios de pagamento no checkout
- Abra o checkout da loja com produtos válidos.
- Preencha os dados necessários e, para produtos físicos, escolha uma entrega.
- Confira os meios exibidos na etapa de pagamento. A integração possui fluxos de Pix, boleto e cartão, mas a disponibilidade depende da habilitação e da configuração da operação.
- Confira o total antes de concluir qualquer pagamento.
Um meio ausente precisa ser verificado na configuração e na habilitação da conta. Não considere todos os meios disponíveis apenas pelo status Conectado.
Passo 5 — Valide um pedido de teste
- No ambiente de teste disponibilizado para sua loja, utilize os dados e procedimentos de simulação fornecidos para esse ambiente.
- Para Pix, confira a geração do QR Code/código e acompanhe a confirmação do pagamento de teste.
- Para boleto, confira a emissão e o acompanhamento até a confirmação. Emitir um boleto não significa que ele foi pago.
- Para cartão, valide os cenários de aprovação e recusa permitidos no ambiente de teste. Uma recusa deve ser apresentada sem tratar a compra como paga.
- Confira o pedido e o valor na Appmax. Após a confirmação, acompanhe o pedido correspondente na Shopify e na Fliper. A atualização pode depender do processamento da integração.
Atenção: em produção, concluir uma compra pode cobrar de verdade. Antes de repetir uma tentativa que terminou sem resposta clara, consulte a Appmax para saber se houve cobrança.
Como confirmar que funcionou
- A Appmax aparece como Conectado na Fliper.
- Os meios habilitados para a loja aparecem no checkout.
- A transação de teste apresenta o resultado esperado e o total correto.
- O pedido aprovado é refletido no acompanhamento da operação; uma transação pendente ou recusada não é apresentada como paga.
Solução de problemas
| O que aconteceu | O que verificar |
|---|---|
| Conectar Appmax não abre a autorização | Confira a mensagem da Fliper, sua sessão e se a loja já foi criada. Tente novamente após corrigir a causa. |
| A autorização mostra Sandbox | Esse é o ambiente de testes. Confirme com o responsável pela implantação a liberação da operação em produção. |
| Autorização cancelada ou expirada | Volte ao painel Fliper e inicie uma nova tentativa. Não reaproveite um endereço de autorização antigo. |
| Autorizou, mas não aparece Conectado | Confira se o navegador retornou à Fliper e a conta escolhida. Se persistir, registre horário e mensagem para análise da instalação. |
| Pix ou boleto gerado, pedido ainda pendente | Geração não é confirmação de pagamento. Confira o estado da transação na Appmax e aguarde a atualização correspondente. |
| Cartão recusado | Confira a mensagem retornada e os dados de teste apropriados. Conexão ativa não garante aprovação de uma transação. |
| Pagamento aprovado na Appmax, mas pendente na Fliper | Confira valor e identificação do pedido e solicite análise do recebimento da confirmação. Não refaça a cobrança para tentar atualizar o status. |
| Pagamento ou autorização sem resposta clara | Consulte o resultado na Appmax antes de repetir a operação. |
Dúvidas frequentes
Preciso informar Client ID e Client secret da Appmax?
O lojista autoriza a integração na Appmax. As credenciais técnicas são tratadas pela plataforma; não são preenchidas manualmente neste fluxo.
A conexão aprova pagamentos automaticamente?
A conexão permite utilizar os meios habilitados. A aprovação de cada transação depende do processamento da Appmax e das condições da operação.
Posso usar a conexão sandbox para vender?
Sandbox serve para testar. Para receber pagamentos reais, a operação precisa estar configurada e validada em produção.
Próximos passos
Revise a Shopify e a Frenet, quando aplicável, e confira o percurso completo: produto, frete, pagamento e acompanhamento do pedido.