FAQ - Nuvemshop

Consulte as principais dúvidas sobre pagamentos, limitações e sincronização da integração entre Asaas e Nuvemshop.

Para instalar ou alterar configurações do módulo, utilize os guias específicos indicados nas respostas.

Quais formas de pagamento são suportadas?

A integração permite receber por:

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

Cartão de débito não é suportado.

Posso utilizar o Sandbox?

Não.

A integração com a Nuvemshop utiliza exclusivamente uma conta Asaas de Produção.

Posso oferecer parcelamento e aplicar juros?

Sim.

O parcelamento está disponível somente para cartão de crédito.

Durante a configuração do módulo, você pode definir:

• quantidade máxima de parcelas;
• juros para cada quantidade de parcelas;
• valor mínimo por parcela.

Se uma compra não atingir o valor mínimo configurado, o checkout poderá apresentar menos parcelas do que o limite máximo definido.

Consulte Configurações iniciais para revisar essas regras.

Posso configurar assinaturas ou cobranças recorrentes?

Não pela integração com a Nuvemshop.

O módulo Asaas para Nuvemshop não suporta cobranças recorrentes.

Se sua operação precisa gerar cobranças periodicamente, consulte Assinaturas no Asaas.

Como os pedidos são atualizados após o pagamento?

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

As mudanças nos pagamentos são enviadas por Webhooks para que o pedido correspondente seja atualizado na Nuvemshop.

%%{init: {"flowchart": {"nodeSpacing": 18,"rankSpacing": 24,"diagramPadding": 4,"padding": 7}}}%%
flowchart TD
    A["Cliente realiza a compra"] --> B["Pagamento é criado no Asaas"]
    B --> C["Pagamento é atualizado"]
    C --> D["Asaas envia o Webhook"]
    D --> E["Pedido é atualizado na Nuvemshop"]

    classDef inicio fill:#DBEAFE,stroke:#2563EB,color:#1E3A8A,stroke-width:3px
    classDef validacao fill:#E0F2FE,stroke:#0284C7,color:#0C4A6E,stroke-width:2px
    classDef sucesso fill:#DCFCE7,stroke:#16A34A,color:#14532D,stroke-width:3px

    class A inicio
    class B,C,D validacao
    class E sucesso

    linkStyle default stroke:#94A3B8,stroke-width:2px

A sincronização é automática. Não é necessário implementar consultas periódicas à API para acompanhar os pedidos criados pelo módulo.

O pedido não atualizou após o pagamento. O que verificar?

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

Se a divergência permanecer:

1. confirme se a cobrança foi atualizada na conta Asaas conectada ao módulo;
2. valide se a integração continua ativa na Nuvemshop;
3. confirme se a API Key configurada continua válida.

Evite alterar o pedido manualmente antes de confirmar se a sincronização ainda está em processamento.

Por que o Pix ficou indisponível?

O Pix pode expirar conforme o período definido na configuração do módulo.

Quando o prazo configurado é atingido, o pagamento deixa de ficar disponível e o pedido poderá ser cancelado.

Revise o período de expiração em Instalando o módulo.

Por que o parcelamento não está disponível?

Verifique:

• o valor total da compra;
• a quantidade máxima de parcelas configurada;
• o valor mínimo permitido por parcela.

O valor mínimo pode reduzir o número de parcelas exibidas ou impedir o parcelamento para determinada compra.

O que verificar se a API Key for recusada?

Confirme se:

• a chave foi copiada integralmente;
• a chave continua ativa;
• a credencial pertence à conta Asaas conectada à loja;
• a chave é de Produção.

Se necessário, crie uma nova API Key e atualize a instalação.

Consulte Instalando o módulo.

Próximos passos

• Instale o módulo Asaas
• Revise as configurações da integração
• Consulte a visão geral da Nuvemshop
• Conheça o fluxo de Assinaturas