Appmax WooCommerce

Description

Compatibilidade

Compatível desde a vers?o 2.2.x do WooCommerce.

Instala??o

Confira o nosso guia de instala??o e configura??o do plugin na aba Installation.

Dúvidas?

Você pode esclarecer suas dúvidas usando:

• Criando um tópico no fórum de ajuda do WordPress.

Installation

Instala??o do plugin:

Antes de instalarmos o plugin, sua loja precisa estar com o WooCommerce instalado e habilitado.

Certifique-se também de que o PHP instalado em seu servidor tenha instalada e habilitada a extens?o php-calendar.

Caso a sua loja WooCommerce possua campos personalizados no checkout, orientamos sempre seguir a conven??o do nome no campo ser em inglês e separado pelo character “_”. Veja a tabela a seguir.

Campo
Nome Padr?o

Bairro
_billing_neighborhood

CPF
_billing_cpf

Número
_billing_number

Após verificar os pré-requisitos, vá para a aba “Plugins” > “Adicionar novo” e pesquise pelo nome Appmax-Woocommerce.

Configura??o do plugin:

Uma vez instalado o plugin, vá para a aba “WooCommerce” > “Configura??es”. E em seguida, clique na tab “Pagamentos”.

Na última linha vai aparecer os métodos de pagamento, s?o eles:

• Appmax – Cart?o de Crédito
• Appmax – Boleto Bancário
• Appmax – Pix

Habilite ambos e em seguida vamos configurar cada método de pagamento.

Configurando o Appmax – Cart?o de Crédito:

Após de clicar em “Gerenciar”, deixe sempre checado a op??o “Ativar Appmax – Cart?o de Crédito”.

Mantenha sempre o padr?o de valores nos campos “Título” e “Descri??o”.

No campo Appmax API Key, cole o token gerado na plataforma da Appmax.

No campo Número de parcelas, selecione a quantidade de parcelas.

No campo Exibir total na parcela, selecione a op??o “sim” caso queira que seja exibido o total da parcela ou selecione a op??o “n?o” para n?o exibir o total na parcela.

No campo Juros de cart?o de crédito, informe os juros de cart?o de crédito. Exemplo: 1.5

No campo Receber Pedidos de CallCenter de Cart?o de Crédito, selecione a op??o “Quando estiver integrado” para receber os pedidos de CallCenter da plataforma Appmax quando os mesmos estiverem com status “Integrado” ou selecione a op??o “Quando estiver pago” para receber os pedidos de CallCenter da paltaforma Appmax quando os mesmos estiverem com status “Aprovado”.

No campo Status dos pedidos em análise antifraude, selecione a op??o “Em processamento” para atualizar o status dos seus pedidos para “Em processamento” ou selecione “Aguardando” para atualizar o status dos seus pedidos para “Aguardando confirma??o de pagamento”. Isso uma vez que, o status do pedido na plataforma Appmax esteja em ‘Análise Antifraude’.

No campo Criar pedido na loja com status, selecione a op??o “Em processamento” para que seus pedidos sejam criados com o status ‘Em processamento’ ou selecione a op??o “Pagamento pendente” para que seus pedidos seja criados com o status ‘Pagamento pendente’.

Para uma vizualiza??o melhor de layout, deixe checado a op??o “Habilitar Checkout Appmax”.

Aten??o: Deixe habilitado a op??o “Habilitar log”. Estando essa op??o habilitado, podemos ver os logs de transa??es de Cart?o de Crédito.

Configurando o Appmax – Boleto Bancário:

Após de clicar em “Gerenciar”, deixe sempre checado a op??o “Ativar Appmax – Boleto Bancário”.

Mantenha sempre o padr?o de valores nos campos “Título” e “Descri??o”.

No campo Appmax API Key, cole o token gerado na plataforma da Appmax.

No campo Dias de Vencimento, informe o número de dias de vencimento dos boletos. Por padr?o o número de dias é 3.

No campo Receber Pedidos de CallCenter de Boleto, selecione a op??o “Quando estiver integrado” para receber os pedidos de CallCenter da plataforma Appmax quando os mesmos estiverem com status “Integrado” ou selecione a op??o “Quando estiver pago” para receber os pedidos de CallCenter da paltaforma Appmax quando os mesmos estiverem com status “Aprovado”.

Aten??o: Deixe habilitado a op??o “Habilitar log”. Estando essa op??o habilitado, podemos ver os logs de transa??es de Boleto Bancário.

Configurando o Appmax – Pix

Após de clicar em “Gerenciar”, deixe sempre checado a op??o “Ativar Appmax – Pix”.

Mantenha sempre o padr?o de valores nos campos “Título” e “Descri??o”.

No campo Appmax API Key, cole o token gerado na plataforma da Appmax.

No campo Receber Pedidos de CallCenter de Pix, selecione a op??o “Quando estiver integrado” para receber os pedidos de CallCenter da plataforma Appmax quando os mesmos estiverem com status “Integrado” ou selecione a op??o “Quando estiver pago” para receber os pedidos de CallCenter da paltaforma Appmax quando os mesmos estiverem com status “Aprovado”.

Aten??o: Deixe habilitado a op??o “Habilitar log”. Estando essa op??o habilitado, podemos ver os logs de transa??es de Pix.

Checkout por Cart?o de Crédito:

Quando o checkout for a op??o Appmax – Cart?o de Crédito, todos os campos s?o obrigatórios e devem ser preenchidos.

Checkout por Boleto Bancário:

Quando o checkout for a op??o Appmax – Boleto Bancário, todos os campos s?o obrigatórios e devem ser preenchidos.

Checkout por Pix

Quando o checkout for a op??o Appmax – Pix, todos os campos s?o obrigatórios e devem ser preenchidos.

Logs:

Para visualizar os logs das transa??es vá para a aba “WooCommerce” > “Status”. E em seguida, clique na tab “Logs”.

Descendo um pouco a página, você verá um seletor de logs.

Aten??o: Sempre verifique se no seletor está selecionado o arquivo de log do dia atual.

Uma vez feita essa verifica??o, clique no bot?o “Visualizar” ao lado do seletor.

Ent?o você estará acompanhando os logs das transa??es.

Os arquivos de logs das transa??es s?o gerados automaticamente e nomeados conforme a escolha do checkout.

Logs de transa??es de Cart?o de Crédito: appmax-credit-card-{DATA-ATUAL}-{HASH}

Logs de transa??es de Boleto: appmax-billet-{DATA-ATUAL}-{HASH}

Logs de transa??es de Pix: appmax-pix-{DATA-ATUAL}-{HASH}

Reviews

N?o funciona! Dá erro crítico no wordpress

gleisonguimaraes February 13, 2023

N?o funciona… dá erro no wordpress

Sem Suporte

gauchopbonline January 5, 2023

Precisa fazer cadastro no APP MAX para eles fazerem uma avalia??o de sua loja pode ou n?o utilizar o gateway de pagamento. Depois de 1 semana eles autorizaram e abriram a conta. Agora.. o plugin está 8 meses sem atualiza??o .e o suporte é muito ruim ! Assim que mudarem e atualizarem volto a mudar minha avalia??o .. N?o é por falta de dinheiro que eles n?o pagam o Dev

Contributors & Developers

Changelog

2.0.46

• Altera??o de mensagem exibida em caso de problemas com pagamento.

2.0.45

• Melhoria da exibi??o de logs.

2.0.44

• Adicionando configura??o em Appmax – Cart?o de Crédito para exibir o total por parcelas.

2.0.43

• Ajuste formulário de pagamento pix.

2.0.42

• Adicionado op??o de pagamento via Pix com notifica??o em caso de pedido aprovado.

2.0.41

• Permitido envio de valores personalizados ao produto através da extens?o do Woocommerce Extra Product Options Builder for WooCommerce.

2.0.40

• Valida??o que checa se o produto da loja tem sku antes de enviar o carrinho.

2.0.39

• Corre??o na valida??o do retorno de acesso ao servidor.

2.0.38

• Ajustando mensagens de retorno para o cliente final.

2.0.37

• Removendo parametro no header para conectar-se na API.

2.0.36

• Ajustando regra de troca de status automática dos pedidos pelo retorno dos webhooks.

2.0.35

• Trocado tipo do campo de CPF e número de cart?o para impedir problemas de máscara em dispositivos android.

2.0.34

• Aplicando corre??o.

2.0.33

• Adicionado campo personalizado appmax_tracking_code.
• Códigos de rastreio adicionados no campo personalizado s?o enviados via API.
• Códigos de rastreio adicionados pelo plugin Claudio Sanches – Correios for WooCommerce s?o enviados via API.

2.0.32

• Ajustando a rotina que monta os itens do carrinho que s?o enviados via API.
• Tratando produtos do tipo Variável.

2.0.31

• Ajustando regra de atualiza??o de status ao retornar webhook.

2.0.30

• Adicionado o campo de configura??o no gateway de Cart?o de Crédito que configura o status do pedido para ser atualizado uma vez que um pedido na plataforma Appmax esteja em Análise Antifraude.

2.0.29

• Enviando o IP do cliente na requisi??o para Api.

2.0.28

• Removendo a verifica??o do fluxo de dados enviado via API adicionada na vers?o 2.0.25.
• Removido um number_format do getPrice() do produto antes de enviar os produtos via API.

2.0.27

• Fazendo um ajuste na URL que faz as requisi??es para a API.

2.0.26

• Adicionando um bot?o para ver o boleto gerado na página de sucesso.

2.0.25

• Adicionando uma verifica??o no fluxo de dados enviados via API.

2.0.24

• Ajustando as rotinas utilizadas nos eventos de webhook.

2.0.23

• Adicionado o campo de configura??o no gateway de Cart?o de Crédito que configura o status inicial ao criar um novo pedido.

2.0.22

• Fazendo novos ajustes ao enviar os dados via API.

2.0.21

• Fazendo um ajuste nos dados enviados via API.

2.0.20

• Adicionando versionamento nas chamadas de arquivos JS e CSS.

2.0.19

• Ajustando a máscara de Telefone.

2.0.18

• Ajustando o envio do Desconto.

2.0.17

• Modificando uma valida??o.

2.0.16

• Fazendo um tratamento para pegar o campo bairro.

2.0.15

• Fazendo um tratamento para pegar o número de endere?o pelo billing-number.
• Exibindo a mensagem de valida??o do endpoint /order quando ocorrer algum erro ao transacionar.

2.0.14

• Alterando o valor de algumas constantes.

2.0.13

• Adicionando novas valida??es no formulário de checkout.

2.0.12

• Ajustes na captura de logs.

2.0.11

• Ajustes na captura de logs.

2.0.10

• Ajustes CSS no formulário de checkout.

2.0.9

• Novas altera??es no formulário de checkout.

2.0.8

• Altera??es no formulário de checkout.

2.0.7

• Separando as regras de valida??o por formulário.

2.0.6

• Ajustando formulários de pagamento do plugin.

2.0.5

• Padronizando campos do checkout.

2.0.4

• Ajustado exibi??o das parcelas.

2.0.3

• Removida Classe Router n?o utilizada.

2.0.2

• Utiliza??o da vers?o 3 da API da plataforma Appmax.

2.0.0

• Valida??o de data de vencimento dos boletos.
• Inser??o de campos de configura??o no gateway de Boleto Bancário.
• Inser??o de campos de configura??o no gateway de Cart?o de Crédito.
• Entrada de informa??es via Webhook.

1.0.9

• Trocando o nome da chave de API

1.0.7

• Corrigindo bug do cálculo de parcelas.

1.0.6

• Corrigindo bug do cálculo de parcelas.

1.0.5

• Alterando endere?o da API.

1.0.4

• Removido o README.md
• Atualizado o readme.txt
• Criado o license.txt

1.0.3

• Altera??es no readme.txt

1.0.2

• Altera??es no README.md

1.0.1

• Altera??es no readme.txt e no README.md

1.0.0

• Vers?o inicial do plugin