Configurações iniciais

Primeiros passos ao usar o Asaas no WooCommerce.

Ativando as formas de pagamento

Após instalar o Plugin Asaas para WooCommerce, é necessário conectar sua loja à sua conta Asaas e habilitar as formas de pagamento que serão disponibilizadas aos seus clientes.

Acesse o menu WooCommerce > Configurações > Pagamentos.

Nesta tela serão exibidas todas as formas de pagamento disponibilizadas pelo Plugin Asaas, permitindo que cada uma seja ativada ou desativada conforme a necessidade da sua loja.

Cada forma de pagamento possui configurações próprias, como parcelamento, notificações, split de pagamento e demais opções específicas.

Ambientes e API Key

Antes de configurar as formas de pagamento, é necessário conectar sua loja WordPress à sua conta Asaas utilizando uma API Key.

Caso deseje realizar testes antes de colocar sua loja em produção, utilize o ambiente Sandbox.

Crie sua conta em:

https://sandbox.asaas.com

Para processar cobranças reais, utilize o ambiente de Produção:

https://www.asaas.com

📘
Importante
Os ambientes Sandbox e Produção são totalmente independentes.
Cada ambiente possui seus próprios clientes, cobranças, configurações e API Keys. Uma API Key criada em Sandbox não funcionará em Produção e vice-versa.

Depois de definir o ambiente, gere uma API Key correspondente.

Na sua conta Asaas, acesse:

Menu do usuário → Integrações → Gerar nova API Key

Copie toda a chave gerada.

Configurando a API Key

Após copiar sua API Key, acesse qualquer uma das formas de pagamento disponibilizadas pelo Plugin Asaas e localize a seção API.

Configure os seguintes campos:

Ambiente: selecione Sandbox para testes ou Produção para cobranças reais.
API Key: cole exatamente a chave gerada na sua conta Asaas, incluindo todos os caracteres.

Após informar os dados, o plugin validará automaticamente a chave.

Em caso de sucesso, será exibida a mensagem:

✅
Chave de API válida

Caso a validação falhe, confirme:

se o ambiente selecionado corresponde ao ambiente da API Key;
se a API Key foi copiada integralmente;
se a chave ainda está ativa na conta Asaas.

Após a validação, salve as alterações.

Impactos operacionais

⚠️
Atenção
Utilizar uma API Key incompatível com o ambiente selecionado impedirá a criação de cobranças pela integração.
Recomendamos realizar todos os testes utilizando o ambiente Sandbox antes de configurar sua loja em Produção.

❗️
Proteja sua API Key
A API Key possui acesso à sua conta Asaas e permite executar operações financeiras.

Nunca compartilhe sua API Key em atendimentos.

Não publique a chave em repositórios públicos.

Armazene-a apenas em ambientes seguros.

Configuração compartilhada

📘
API Key e Webhook
A configuração de API Key e Webhook aparece em todas as formas de pagamento do Plugin Asaas, porém ela é compartilhada entre todas elas.
Dessa forma, basta realizar essa configuração uma única vez.
Para entender como funciona a sincronização automática dos pedidos e a configuração do webhook, consulte a página Webhooks.