Instalando o plugin

Como usar o Asaas no WooCommerce.

Esta página apresenta os pré-requisitos para utilização do Plugin Asaas para WooCommerce e o processo de instalação no WordPress.

Após concluir a instalação, siga para a página Configurações iniciais, onde será realizada a conexão da loja com sua conta Asaas por meio da API Key.


Antes de instalar

Antes de iniciar a instalação, confirme que:

  • sua loja utiliza WordPress;
  • o WooCommerce está instalado e funcionando;
  • você possui uma conta Asaas (Sandbox ou Produção);
  • você possui permissões de administrador no WordPress para instalar plugins.

Caso pretenda vender assinaturas, também será necessário utilizar o plugin WooCommerce Subscriptions.


Requisitos mínimos

Para garantir compatibilidade com as versões atuais do plugin e receber futuras atualizações, recomendamos utilizar no mínimo:

  • PHP: 7.0 ou superior;
  • WordPress: 4.4 ou superior;
  • WooCommerce: 5.0 ou superior.

Caso utilize cobranças recorrentes, também será necessário instalar o WooCommerce Subscriptions.


Plugins necessários

O funcionamento do Plugin Asaas depende de outros plugins do ecossistema WooCommerce.

Alguns são obrigatórios e outros dependem dos recursos utilizados pela sua loja.

PluginObrigatórioQuando utilizar
WooCommerceSimResponsável por transformar o WordPress em uma loja virtual, permitindo o cadastro de produtos, pedidos, carrinho de compras e checkout.
Brazilian Market on WooCommerceSimAdiciona ao checkout campos utilizados no mercado brasileiro, como CPF, CNPJ, telefone, CEP e endereço.
WooCommerce SubscriptionsApenas para assinaturasNecessário para vendas recorrentes por assinatura utilizando o Plugin Asaas.

Ao instalar o Plugin Asaas, o próprio WordPress poderá sugerir automaticamente a instalação dos plugins obrigatórios e opcionais compatíveis.


Instalando o Plugin Asaas

A instalação do Plugin Asaas é simples e pode ser realizada diretamente pelo painel administrativo do WordPress.

📘

Instalação pela página oficial de plugins do WordPress

No menu Plugins do WordPress, pesquise por Asaas.

Localize o plugin Meio de Pagamento Asaas para WooCommerce e clique em Instalar agora.

Após a instalação, clique em Ativar.

🚧

Ative a atualização automática do plugin

Recomendamos manter a atualização automática habilitada para utilizar sempre a versão mais recente do Plugin Asaas, garantindo acesso às últimas melhorias, correções de segurança e compatibilidade com novas versões do WooCommerce.


Após a instalação

Depois de ativar o plugin:

  • o método de pagamento Asaas será disponibilizado nas configurações do WooCommerce;
  • será possível conectar sua loja à conta Asaas utilizando uma API Key;
  • as formas de pagamento poderão ser habilitadas individualmente;
  • o webhook será configurado durante a etapa de configuração inicial da integração.

Boas práticas

  • mantenha o Plugin Asaas sempre atualizado;
  • mantenha também o WordPress e o WooCommerce atualizados;
  • realize os primeiros testes utilizando o ambiente Sandbox;
  • faça backup da loja antes de realizar grandes atualizações;
  • utilize apenas plugins compatíveis com a versão do WooCommerce instalada.

Próximos passos

Após concluir a instalação do plugin:

  1. Configure o ambiente (Sandbox ou Produção);
  2. Informe sua API Key;
  3. Valide a conexão com o Asaas;
  4. Configure as formas de pagamento desejadas;
  5. Realize testes no checkout;
  6. Publique a integração em produção.

Conteúdos relacionados

  • Configurações iniciais
  • Forma de pagamento
  • Formas de cobrança
  • Webhooks
  • Erros comuns


Did this page help you?