Guia rápido: conectar o Asaas

Prepare a chave no Asaas

1. 1Entre na conta Asaas do ambiente que pretende usar. Produção e sandbox usam contas e chaves correspondentes ao próprio ambiente.
2. 2No Asaas, abra Integrações → Chaves de API e gere uma nova chave para a Vitruni. Siga as verificações de segurança solicitadas pelo Asaas.
3. 3Copie a chave completa e guarde-a de forma segura. Não compartilhe a senha da conta ou os códigos de autenticação.

Conecte na Vitruni

1. 1Abra Pagamentos → Adicionar gateway → Asaas.
2. 2Selecione o mesmo ambiente da chave e cole-a em Chave de API.
3. 3Conclua a conexão e aguarde a validação. A Vitruni também prepara o recebimento das confirmações de pagamento.
4. 4Se aparecer Conexão pendente, use Tentar novamente. A conta só deve ser escolhida para novos pedidos quando a configuração estiver pronta.

Escolha a conta que receberá os pedidos

Conectar uma conta e selecionar o recebimento são etapas diferentes. Na linha da conta conectada, use Usar nos novos pedidos e confirme. O selo Recebendo pedidos identifica a conta ativa. Só uma conta recebe os novos pedidos por vez; trocar a conta não move os pagamentos dos pedidos anteriores.

Confira antes de divulgar a loja

Abra a loja como cliente, adicione um produto e avance até as opções de pagamento. Confira a conta e o ambiente selecionados no painel. Em produção, concluir um pagamento movimenta dinheiro real. Só considere o teste aprovado quando o pedido mostrar a confirmação do pagamento; abrir ou voltar da página do provedor não comprova que ele foi pago.

Chave recusada ou expirada

Confira o ambiente, a validade e as permissões da chave no Asaas. Ao substituir uma chave, atualize a conexão antes de revogar a antiga, para não interromper as consultas dos pedidos. Se o painel continuar indicando pendência, informe ao suporte o horário e a mensagem exibida, sem enviar a chave.