Configurações iniciais
Configurando o módulo
Configure os pagamentos do Asaas na Nuvemshop
Após instalar o módulo Asaas, ajuste as regras que serão aplicadas aos pagamentos exibidos no checkout da Nuvemshop.
Nesta etapa, você pode revisar parcelamento, juros, descontos, vencimento do boleto e expiração do Pix.
Antes de começar
Confirme que:
- o módulo Asaas está instalado e ativo;
- a loja está conectada à conta Asaas correta;
- uma API Key válida de Produção está configurada;
- o Asaas está disponível entre os meios de pagamento da loja.
Se ainda não concluiu a instalação, consulte Instalando o módulo.
AtençãoA integração entre Asaas e Nuvemshop não possui suporte ao ambiente Sandbox.
Após alterar as configurações, realize compras de teste controladas, com valores baixos, antes de disponibilizar as novas regras aos clientes.
Acesse as configurações
No painel administrativo da Nuvemshop:
- Acesse Configurações > Meios de Pagamento.
- Localize o Asaas.
- Clique em Editar.
As alterações realizadas nessa área serão aplicadas às próximas vendas da loja.
Revise as regras de pagamento
As configurações do módulo incluem:
| Configuração | Efeito no checkout |
|---|---|
| Quantidade máxima de parcelas | Define o limite de parcelas exibidas no cartão de crédito. |
| Juros por parcela | Define os juros aplicados conforme a quantidade de parcelas. |
| Valor mínimo da parcela | Pode limitar a quantidade de parcelas disponíveis para uma compra. |
| Vencimento do boleto | Define por quantos dias o boleto permanecerá válido. |
| Expiração do Pix | Define por quanto tempo o pagamento Pix permanecerá disponível. |
| Desconto por forma de pagamento | Altera o valor final conforme Pix, boleto ou cartão de crédito. |
Para os formatos aceitos na expiração do Pix e a configuração inicial de parcelamento, consulte Instalando o módulo.
Valor mínimo da parcela
Defina o menor valor permitido para cada parcela de uma compra no cartão de crédito.
Por exemplo, em uma compra de R$ 60,00:
- valor mínimo de R$ 20,00 permite até 3 parcelas;
- um valor mínimo maior pode reduzir a quantidade de parcelas disponíveis.
O limite final também depende da quantidade máxima de parcelas configurada no módulo.
Descontos por forma de pagamento
Você pode configurar descontos diferentes para:
- cartão de crédito;
- boleto bancário;
- Pix.
O desconto é aplicado quando o comprador seleciona a forma de pagamento correspondente no checkout.
Revise o valor final apresentado ao cliente sempre que alterar essa configuração.
Salve e valide as alterações
Após concluir os ajustes:
- salve as configurações;
- realize uma compra de teste controlada;
- selecione cada forma de pagamento alterada;
- confirme as opções exibidas no checkout;
- valide o valor final da compra;
- no cartão de crédito, confira a quantidade de parcelas e os juros aplicados;
- confirme se o pedido é atualizado após a alteração do pagamento.
Resultado esperado
O checkout deve apresentar somente as condições configuradas para cada forma de pagamento.
No cartão de crédito, a quantidade de parcelas deve respeitar o limite máximo e o valor mínimo por parcela. Os descontos devem ser refletidos no valor apresentado ao comprador.
Recomendado
- Testar os meios de pagamento após qualquer alteração.
- Validar se as regras de parcelamento atendem ao modelo de negócio da loja.
- Revisar os descontos aplicados para evitar divergências comerciais.
- Confirmar o valor final apresentado ao comprador no checkout.
- Monitorar as primeiras vendas após alterações nas configurações.
Erros comuns
Parcelamento não aparece como esperado
Verifique:
- a quantidade máxima de parcelas;
- o valor mínimo configurado por parcela;
- o valor total da compra.
O valor mínimo pode reduzir a quantidade de parcelas disponíveis no checkout.
Desconto diferente do esperado
Confirme a regra configurada para a forma de pagamento selecionada e valide o valor final diretamente no checkout.
Pedido não atualizou após o pagamento
A sincronização entre Asaas e Nuvemshop ocorre automaticamente por Webhooks.
Em caso de indisponibilidade temporária, a atualização pode ocorrer alguns instantes após o evento financeiro.
Consulte o FAQ da Nuvemshop para outros comportamentos da integração.
Próximos passos
Updated 18 days ago