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.0ou superior; - WordPress:
4.4ou superior; - WooCommerce:
5.0ou 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.
| Plugin | Obrigatório | Quando utilizar |
|---|---|---|
| WooCommerce | Sim | Responsável por transformar o WordPress em uma loja virtual, permitindo o cadastro de produtos, pedidos, carrinho de compras e checkout. |
| Brazilian Market on WooCommerce | Sim | Adiciona ao checkout campos utilizados no mercado brasileiro, como CPF, CNPJ, telefone, CEP e endereço. |
| WooCommerce Subscriptions | Apenas para assinaturas | Necessá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.
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 pluginRecomendamos 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:
- Configure o ambiente (Sandbox ou Produção);
- Informe sua API Key;
- Valide a conexão com o Asaas;
- Configure as formas de pagamento desejadas;
- Realize testes no checkout;
- Publique a integração em produção.
Conteúdos relacionados
- Configurações iniciais
- Forma de pagamento
- Formas de cobrança
- Webhooks
- Erros comuns
Updated 20 days ago
