FAQ - Nuvemshop

Esta seção reúne as principais dúvidas sobre a integração entre Asaas e Nuvemshop.

O plugin oficial permite utilizar o Asaas como gateway de pagamentos da loja, processando pedidos através de Pix, boleto bancário e cartão de crédito.

Além das perguntas mais frequentes, esta página apresenta limitações, comportamentos importantes e recomendações para utilização da integração.

Regras importantes da integração

Antes de utilizar o plugin, considere que:

• a integração opera exclusivamente utilizando a conta de produção do Asaas;
• o plugin não possui suporte para ambiente Sandbox;
• pagamentos recorrentes não são suportados pela Nuvemshop;
• parcelamentos são permitidos apenas para cartão de crédito;
• as regras de juros são configuradas durante a instalação do módulo;
• as notificações entre as plataformas são realizadas automaticamente através de webhooks.

Configurações e parâmetros importantes

Durante a instalação e configuração do módulo, alguns parâmetros influenciam diretamente o comportamento da integração:

Essas configurações podem ser alteradas nas configurações do módulo e impactam diretamente a experiência de compra do cliente.

É possível utilizar o plugin no ambiente Sandbox?

Não.

A conexão com a loja é realizada exclusivamente utilizando a conta de produção do Asaas.

🚧

Atenção

Como não existe suporte para Sandbox, recomenda-se utilizar valores baixos e realizar compras de teste controladas antes de disponibilizar a loja para os clientes.

Posso oferecer pagamentos via cartão de débito?

Não.

Atualmente, a integração suporta apenas:

• Pix;
• boleto bancário;
• cartão de crédito.

É possível gerar vendas parceladas?

Sim.

Parcelamentos são suportados exclusivamente em pagamentos com cartão de crédito.

A quantidade máxima de parcelas e as regras de juros são definidas durante a configuração do módulo.

É possível aplicar juros no parcelamento?

Sim.

Ao habilitar parcelamento, a integração permite configurar juros específicos para cada quantidade de parcelas.

Essas regras são aplicadas automaticamente no checkout e influenciam diretamente o valor final apresentado ao comprador.

📘

Importante

O valor mínimo por parcela também pode limitar a quantidade de parcelas disponíveis para determinadas compras.

É possível gerenciar assinaturas através da Nuvemshop?

Não.

Por se tratar de uma plataforma voltada para e-commerce, a Nuvemshop não oferece suporte para cobranças recorrentes.

Caso exista necessidade de trabalhar com assinaturas, recomenda-se utilizar os recursos de assinaturas diretamente no Asaas através da API ou da interface da plataforma.

Recebo atualizações sobre os pagamentos?

Sim.

Durante a instalação do módulo, a comunicação entre Asaas e Nuvemshop é configurada automaticamente.

Sempre que ocorrer uma alteração no pagamento, a loja receberá atualizações para sincronização do pedido.

Entre os eventos mais comuns estão:

• pagamento confirmado;
• pagamento pendente;
• cancelamento;
• expiração do Pix;
• vencimento do boleto;
• estorno.

Como funcionam as notificações entre as plataformas?

A sincronização entre Asaas e Nuvemshop é realizada automaticamente através de webhooks.

Essas notificações permitem que os pedidos sejam atualizados conforme os eventos financeiros da cobrança.

Em caso de indisponibilidade momentânea entre as plataformas, as atualizações podem ocorrer alguns instantes após o evento financeiro.

Exemplos práticos

Exemplo de parcelamento

Uma loja pode configurar:

• até 6 parcelas no cartão de crédito;
• juros diferentes para cada quantidade de parcelas;
• valor mínimo de R$ 20,00 por parcela.

Nesse cenário, um pedido de R$ 100,00 poderá apresentar menos opções de parcelamento caso o valor mínimo configurado não seja atingido.

Exemplo de atualização automática do pedido

Fluxo típico:

Cliente realiza uma compra
↓
Pagamento criado no Asaas
↓
Pagamento confirmado
↓
Webhook enviado automaticamente
↓
Pedido atualizado na Nuvemshop

Esse comportamento ocorre automaticamente após a instalação do módulo.

Quais são os erros mais comuns?

API Key inválida

Pode ocorrer quando a chave configurada pertence a outra conta ou foi informada incorretamente.

Parcelamento indisponível

Pode ocorrer quando o valor mínimo da parcela configurado é superior ao permitido para a compra.

Pix expirado

Quando o período de expiração configurado é atingido, o pedido poderá ser cancelado.

Divergência entre pagamento e pedido

Em situações de indisponibilidade temporária, a atualização do pedido pode ocorrer alguns instantes após a confirmação do pagamento.

Boas práticas

📘

Recomendado

• Realizar compras de teste após alterações nas configurações.
• Revisar periodicamente as regras de parcelamento e juros.
• Utilizar uma API Key válida da conta de produção.
• Monitorar os pedidos após alterações no módulo.
• Validar o comportamento do checkout antes de iniciar campanhas ou grandes volumes de venda.

Conteúdos relacionados

• Instalação do módulo Asaas para Nuvemshop.
• Configurações iniciais.
• Configuração da conta Asaas.
• Documentação de Webhooks.
• Formas de pagamento disponíveis.