Nuvemshop

A Nuvemshop é uma plataforma de e-commerce que permite criar e gerenciar lojas virtuais sem necessidade de desenvolvimento próprio.

O Asaas possui integração oficial com a Nuvemshop, atuando como gateway de pagamentos da loja. Com essa integração, os pedidos realizados na plataforma são processados pelo Asaas, permitindo disponibilizar pagamentos via Pix, boleto bancário e cartão de crédito diretamente no checkout.

Esta seção reúne os conteúdos necessários para instalar, configurar e operar a integração entre Nuvemshop e Asaas.

Quando utilizar

A integração é indicada para lojas que desejam:

• utilizar o Asaas como gateway de pagamentos da Nuvemshop;
• aceitar pagamentos via Pix, boleto bancário e cartão de crédito;
• disponibilizar parcelamento para compras no cartão;
• utilizar um módulo pronto sem necessidade de desenvolvimento personalizado;
• centralizar o processamento financeiro das vendas na conta Asaas.

Como funciona a integração

Após a instalação do módulo do Asaas na Nuvemshop, os pedidos realizados pelos clientes passam a ser processados pela conta Asaas configurada na integração.

Uma jornada típica segue o fluxo abaixo:

Criar conta Asaas
↓
Instalar módulo Asaas na Nuvemshop
↓
Configurar API Key
↓
Definir formas de pagamento
↓
Publicar a loja
↓
Receber pedidos
↓
Processar pagamentos através do Asaas
↓
Receber notificações automáticas da operação

Requisitos para utilização

Antes de instalar o módulo, é necessário que:

• a loja esteja ativa na Nuvemshop;
• o plano da loja seja compatível com utilização de meios de pagamento externos;
• exista uma conta Asaas ativa;
• a API Key da conta Asaas esteja disponível;
• as formas de pagamento desejadas estejam definidas.

Formas de pagamento disponíveis

A integração permite receber pagamentos através de:

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

📘

Importante

Atualmente, pagamentos via cartão de débito e cobranças recorrentes não são suportados pela integração com a Nuvemshop.

Configurações importantes

Durante a configuração do módulo, é possível definir:

• vencimento padrão dos boletos;
• período de expiração do Pix;
• quantidade máxima de parcelas;
• juros por parcela;
• valor mínimo por parcela;
• descontos para Pix, boleto e cartão.

Essas configurações influenciam diretamente o comportamento do checkout da loja.

Comportamentos importantes

Ao utilizar a integração, considere que:

• os pagamentos são processados pela conta Asaas configurada;
• os pedidos da Nuvemshop recebem atualizações automáticas de pagamento;
• webhooks são utilizados para sincronização entre as plataformas;
• vendas parceladas são permitidas apenas no cartão de crédito;
• assinaturas recorrentes não são suportadas pela plataforma.

Boas práticas

• Utilize sempre uma API Key de produção válida.
• Teste as formas de pagamento antes de publicar a loja.
• Defina corretamente vencimentos de Pix e boletos.
• Revise as regras de parcelamento antes de disponibilizá-las aos clientes.
• Mantenha os dados da conta Asaas atualizados.
• Monitore as notificações da loja após a instalação.

Próximos passos

Para concluir a configuração da integração, consulte os conteúdos desta seção:

• Instalação do módulo Asaas.
• Configurações iniciais.
• Perguntas frequentes (FAQ).