Token Asaas
O token do Asaas é a chave de API da conta Asaas da sua empresa. É ela que deixa a plataforma criar o link de pagamento de um pedido na sua conta Asaas e saber quando o cliente pagou. O dinheiro cai direto na sua conta, com as tarifas do seu contrato com o Asaas.
A mesma chave serve aos dois recursos que usam o Asaas, se estiverem disponíveis no seu plano: o link de pagamento do pedido do PDV e o bloco Asaas do FlowBuilder, que envia ao cliente a segunda via de uma cobrança. O PDV lê a chave das Opções da empresa; o bloco tem o próprio campo de token.
Resumo Prático
No Asaas, gere a chave de API em Integrações → Chaves de API.
Na plataforma, acesse o menu Configurações → Opções, cole a chave em Token do Asaas da empresa (links de pagamento do PDV) e clique em Salvar.
Copie o endereço do campo Aviso do Asaas para o PDV (webhook) e cadastre nos webhooks do Asaas.
Como criar a chave de API no Asaas
Entre na sua conta em https://www.asaas.com.
No canto superior direito, clique no ícone do seu usuário e em Integrações.
Na aba Chaves de API, clique em Gerar chave de API, dê um nome à chave e confirme.
Copie a chave na hora e guarde em local seguro: o Asaas mostra a chave inteira uma vez só.
Use a chave da conta de produção, que começa com $aact_prod_. A chave do ambiente de testes do Asaas (sandbox), que começa com $aact_hmlg_, não gera link de pagamento na plataforma.
Como integrar o Asaas à nossa plataforma
Acesse o menu Configurações → Opções
Token do Asaas da empresa (links de pagamento do PDV): cole a chave e clique em Salvar. O botão ao lado do campo mostra ou esconde o token.
Aviso do Asaas para o PDV (webhook): é o endereço que avisa a plataforma quando o cliente paga. Copie o endereço deste campo para o próximo passo.
Só o administrador da empresa vê e muda esses dois campos.
Cadastrar o aviso no Asaas
No Asaas, em Integrações, abra a aba Webhooks e adicione um webhook novo.
Dê um nome, como Pedidos da plataforma, e cole no campo URL o endereço do Aviso do Asaas para o PDV (webhook).
Deixe o webhook ativo, marque os eventos de cobrança e salve.
Como fica no pedido
Com o token salvo, o pedido confirmado ganha o botão Gerar link do Asaas na parte de pagamentos. O cliente recebe na conversa "Pague o pedido #N (R$ X) por este link:" com o link, e escolhe como pagar na página do Asaas.
Com o aviso cadastrado, o pedido fica Pago sozinho poucos segundos depois do pagamento. Sem o aviso, clique em Conferir no Asaas, na linha do link, para a plataforma buscar o pagamento.
O Asaas só gera link a partir de R$ 10,00.
Boas práticas para gerenciar a chave
Não compartilhe a chave: ela dá acesso à sua conta financeira no Asaas.
Uma chave por integração: com uma chave para a plataforma e outra para cada sistema, você apaga uma sem parar as outras.
Chave vazada: apague a chave no Asaas, gere uma nova e cole a nova no campo Token do Asaas da empresa, e também no bloco Asaas do FlowBuilder, se usar a mesma chave lá.
Dúvidas Comuns
O botão Gerar link do Asaas mostra "Não foi possível falar com o servidor". O que fazer? A mesma mensagem aparece quando o Asaas recusa o pedido. Confira se o pedido tem pelo menos R$ 10,00 e se o Token do Asaas da empresa é a chave de produção, que começa com $aact_prod_.
O cliente pagou pelo link do Asaas e o pedido continua Não pago. Por quê? O aviso do Asaas não chegou: confira se o endereço do Aviso do Asaas para o PDV (webhook) está cadastrado e ativo nos webhooks do Asaas, com os eventos de cobrança. Enquanto isso, Conferir no Asaas, na linha do link, dá a baixa.
Estornei no pedido um pagamento feito pelo link do Asaas. O dinheiro volta para o cliente? Não. Estornar registra o estorno só no pedido. A devolução do dinheiro é feita na sua conta Asaas.
O link do Asaas continua habilitado depois que o cliente pagou. Preciso fazer algo? O link do pedido continua Habilitado em Links de Pagamento, no Asaas. Para ninguém pagar o mesmo link de novo, desative o link por lá.
Posso testar o link de pagamento do pedido com a conta de testes do Asaas? Não. O link de pagamento do pedido usa só o Asaas de produção, e a chave do ambiente de testes não gera link.