No AppMax você precisará:
- Criar uma conta Appmax;
- Copiar o Token Appmax;
Na wBuy você precisará:
- Colar seu Token Appmax;
- Instalar o aplicativo;
- Configurar o Webhook de atualização;
Criar conta e pegar o token
Para conseguirmos começar com o passo a passo, é necessário que tenha uma conta Appmax. Caso não possua, pode criar uma conta acessando o seguinte link: Appmax e wBuy
No ambiente appmax, acesse sua conta e clique em Integrações.
Ao acessar o menu Integrações, clique em Appmax API.
Após selecionar o Appmax API, você irá informar todos os dados solicitados para criação de sua loja.
Terá de solicitar junto ao suporte os dados de Chave API e Token para que seja configurado no aplicativo Appmax, dentro do painel wBuy.
Configurando Webhook
O Webhook permite com que comunicações ocorram de forma automática entre sistemas. Para que seus pedidos tenham status de pedidos atualizado automaticamente
é necessário a configuração do Webhook wBuy em seu ambiente Appmax.
Acesse seu painel Appmax e clique em Configurações, depois em Apphooks (Webhook).
Dentro da página de Apphooks, selecione "Novo Webhook".
- Na criação do Webhook selecione sua loja e configure a URL: https://sistema.sistemawbuy.com.br/notificacoes/appmax no campo "URL para Envio".
- Em Eventos, selecione:
Pedido Aprovado;
Pedido Autorizado;
Pedido Pago;
Pedido Estornado;
Pix Expirado;
Pedido Autorizado com atraso (60min);
Pagamento não autorizado com atraso (60min);
Pagamento não autorizado;
Instalando o Aplicativo
Acesse seu painel wBuy, clique em Configurações > Formas de Pagamento > Adicionar, após isso pesquise por "Appmax".
Neste aplicativo você irá inserir o Token e ativar a opção "Status na Loja".
Mapeamento de status
Quando a notificação chega, analisamos o Evento e o Status informados pela Appmax e convertemos para o status correspondente na sua loja:
| Status / Evento na Appmax | Status Atualizado na Loja | O que significa? |
| pendente (ou evento Pix/Boleto) | Aguardando Pagamento | O cliente gerou o Pix ou o Boleto e o sistema aguarda a compensação financeira. |
| autorizado / OrderAuthorized | Pagamento em Análise | O cartão do cliente passou na pré-autorização e o pedido está sendo avaliado pelo antifraude interno. |
| aprovado, integrado, OrderPaid, OrderAuthorizedWithDelay | Pagamento Efetuado | O pagamento foi confirmado com sucesso e o pedido está liberado para faturamento/envio. |
| recusado, recusado_por_risco | Pagamento Negado | O pagamento foi negado pela operadora do cartão ou recusado pela análise de risco (antifraude). |
| cancelado, OrderPixExpired | Pedido Cancelado | O Pix expirou sem pagamento, a transação foi recusada ou o pedido foi cancelado na Appmax. |
| estornado, OrderRefund | Devolvido / Reembolsado | O valor do pedido foi reembolsado/estornado ao cliente. |
Regras de Segurança e Proteção
Para garantir a integridade dos seus dados e evitar atualizações desnecessárias, nosso sistema aplica as seguintes regras no recebimento das notificações:
Prevenção de Duplicidade: Se a Appmax enviar uma notificação para um pedido que já está no mesmo status, o sistema ignora a notificação e registra que a ação já foi concluída.
Proteção de Pedidos Pagos: Se um pedido já consta como Pagamento Efetuado na sua loja, o sistema protege o pedido contra alterações regressivas acidentais vindas de webhooks secundários.
Validação de Notificações: Não Reconhecidas: Notificações que não pertencem a um pedido cadastrado ou que trazem eventos desconhecidos são descartadas com segurança sem afetar a sua loja.
Perguntas Frequentes (FAQ)
- Quanto tempo leva para o status mudar na minha loja?
A atualização ocorre em poucos segundos após o envio da notificação pela Appmax.
- O que acontece quando um pedido vai para o Antifraude?
Quando a Appmax pré-autoriza o cartão e envia para análise manual ou diferida de risco (OrderAuthorized / OrderAuthorizedWithDelay), o pedido fica marcado na loja como Pagamento em Análise. Assim que o antifraude aprovar ou recusar, uma nova notificação atualizará para Pagamento Efetuado ou Pagamento Negado.
- Por que um pedido de Pix expirado mudou para "Pedido Cancelado"?
Quando o cliente não realiza o pagamento dentro do prazo de validade do QR Code Pix, a Appmax envia o evento OrderPixExpired, fazendo com que o pedido seja cancelado automaticamente na sua loja para liberar o estoque.
Pronto! Seus pagamentos a partir deste momento serão processados pela Appmax e atualizações enviadas autoamticamente para wBuy.