Instalando o módulo
Como usar o Asaas na Nuvemshop
Instale o módulo oficial do Asaas para utilizar Pix, boleto bancário e cartão de crédito no checkout da Nuvemshop.
A instalação conecta sua loja a uma conta Asaas de Produção e permite configurar as regras iniciais de cobrança.
Antes de começar
Confirme que:
- sua loja está, no mínimo, no plano Essencial da Nuvemshop;
- você possui acesso administrativo à loja;
- utilizará uma conta Asaas de Produção existente ou criará uma conta durante a instalação.
Se a loja estiver no plano Gratuito, a Nuvemshop permite migrar de plano e testar os recursos do plano por um período de trial gerenciado pela própria plataforma.
Para consultar o plano atual, clique no nome da loja no canto superior direito do painel administrativo e acesse Planos.
A integração disponibiliza:
- Boleto bancário à vista;
- Pix à vista;
- Cartão de Crédito à vista ou parcelado.
1. Instale o módulo
No painel administrativo da Nuvemshop:
- Acesse Meus aplicativos.
- Clique em Impulsione seu negócio.
- Procure por Asaas na loja de aplicativos.
- Clique em Instalar aplicativo.
- Revise as permissões solicitadas.
- Clique em Aceitar e começar a usar.
Você também pode acessar a loja de aplicativos da Nuvemshop.
Após autorizar a instalação, escolha entre conectar uma conta Asaas existente ou criar uma conta.
2. Conecte sua conta Asaas
Se você já possui uma conta, selecione Tem conta Asaas.
No campo Asaas API Key, informe uma chave de API válida da sua conta de Produção.
Para criar uma chave:
- Acesse a interface web do Asaas.
- Vá até Integrações > Chaves de API.
- Crie uma nova chave.
- Copie o valor exibido.
A chave é exibida apenas uma vez e não pode ser recuperada posteriormente. Armazene-a antes de sair da tela.
Consulte como criar e gerenciar chaves de API.
Volte à instalação na Nuvemshop e cole a chave completa no campo Asaas API Key.
3. Configure as cobranças
Durante a instalação, defina as regras iniciais utilizadas pelo módulo.
Vencimento do boleto
Em Nº de dias vencimento de boleto, informe quantos dias serão adicionados à data da compra para definir o vencimento.
O valor padrão é 5.
Por exemplo, se a compra ocorrer hoje, um valor 5 fará o boleto vencer cinco dias depois.
Expiração do Pix
Em Período de expiração (Pix), defina por quanto tempo o pagamento permanecerá disponível.
Formatos aceitos:
| Valor | Resultado |
|---|---|
10m | 10 minutos — mínimo permitido |
3h | 3 horas |
1d | 1 dia |
5 | 5 dias |
10 | 10 dias |
Quando nenhum sufixo é informado, o valor é interpretado em dias.
Se o campo ficar vazio, não será definida uma expiração personalizada para o Pix.
Após atingir o período configurado, o Pix expira e o pedido poderá ser cancelado.
Parcelamento no cartão de crédito
Selecione a quantidade máxima de parcelas que deseja disponibilizar.
Ao habilitar o parcelamento, o módulo apresenta campos adicionais para definir os juros aplicados a cada quantidade de parcelas.
Em Valor mínimo de cada parcela, defina o menor valor permitido para uma parcela.
Se o valor mínimo não for atingido, o número de parcelas apresentado ao comprador poderá ser reduzido ou o parcelamento poderá ficar indisponível.
Após concluir as configurações, clique em Salvar.
As regras podem ser revisadas posteriormente conforme descrito em Configurações iniciais.
Se você ainda não possui uma conta Asaas
Caso ainda não possua uma conta no Asaas, será possível fazer a abertura da conta diretamente pela instalação do módulo Asaas na Nuvemshop.
Selecionando essa opção, além das configurações do módulo exibidas nessa seção, você também precisará informar os dados de sua empresa/pessoa física para que a conta Asaas seja aberta.
Será necessário informar: Nome, E-mail, CPF ou CNPJ, Celular, Fone Fixo, Endereço, Número, Bairro e CEP.
Após informar todos os campos e também definir as configurações do módulo, basta clicar em "Salvar" para realizar a finalização dos ajustes.
Você receberá na sequência um e-mail do Asaas para definir a sua senha de acesso de nossa plataforma. Uma vez definido, poderá acessar o Asaas pelo nosso site e realizar a conclusão de seu cadastro (envio de documentos, informativos adicionais, etc)
Valide a instalação
Após salvar:
- confirme que o Asaas aparece em Configurações > Meios de Pagamento da Nuvemshop;
- revise os meios de pagamento habilitados;
- realize uma compra de teste controlada;
- confirme se a cobrança foi criada na conta Asaas;
- acompanhe se o pedido recebe a atualização após a alteração do pagamento.
Boas práticas
- Utilize sempre uma API Key válida da conta de produção.
- Armazene a API Key em local seguro.
- Teste os meios de pagamento antes de colocar a loja em operação.
- Revise os prazos de vencimento de boleto e expiração do Pix.
- Valide as regras de parcelamento e juros antes de disponibilizá-las aos clientes.
Resultado esperado
O módulo deve permanecer ativo, conectado à conta Asaas e disponível entre os meios de pagamento da Nuvemshop.
As cobranças criadas pela loja devem aparecer na conta Asaas e as alterações dos pagamentos devem atualizar os pedidos automaticamente por meio da comunicação configurada pela integração.
Problemas comuns
API Key inválida
Confirme se:
- a chave foi copiada integralmente;
- a chave continua ativa;
- a credencial pertence à conta de Produção utilizada pela integração.
Se necessário, crie uma nova API Key.
Pix expirado
Quando o período configurado é atingido, o pagamento deixa de ficar disponível e o pedido poderá ser cancelado.
Parcelamento indisponível
Verifique se o Valor mínimo de cada parcela é compatível com o valor da compra.
Essa regra pode reduzir a quantidade de parcelas apresentadas ao comprador.
Pedido não atualizou após o pagamento
A integração utiliza Webhooks para sincronizar automaticamente Asaas e Nuvemshop.
Em situações de indisponibilidade temporária, a atualização pode ocorrer alguns instantes depois da alteração do pagamento.
Consulte o FAQ da Nuvemshop para outros comportamentos e limitações.
Próximos passos
Updated 4 days ago