[Stripe] Como habilitar a integração

Neste artigo, vamos te mostrar como configurar um produto padrão na integração com a Stripe para que vendas sem produto associado possam ser importadas e utilizadas na emissão das notas fiscais.

Em algumas integrações com plataformas que atuam como meio de pagamento, a informação dos produtos adquiridos pelos compradores não é disponibilizada na importação das vendas para o seu painel da eNotas.

Para atender a esses casos, a eNotas disponibiliza a configuração de produto padrão, em que você pode selecionar um produto no eNotas para ser utilizado na descrição da nota fiscal.

Siga os passos abaixo para configurar um produto padrão ou alterar o produto padrão que está sendo utilizado na integração com a Stripe:

1. Faça login em sua conta na eNotas.
2. Vá em Gerenciar.
3. Clique na opção Apps.
4. Localize a integração com a Stripe e clique em Editar.
5. Caso você não possua um produto padrão associado à sua integração, clique em "Alterar" em "Vendas sem produto estão sendo ignoradas."
6. Caso você já possua um produto padrão associado à sua integração e queira alterá-lo, clique em "Alterar" em "Vendas sem produto estão sendo criadas com o produto..."
7. Informe o nome do produto padrão que deverá ser utilizado no eNotas para emissão das notas. Por exemplo: Assinatura.
8. Busque o produto ou, caso seja um produto novo, crie seu cadastro.
9. Se for um novo produto, preencha:

• o nome do produto;
• a garantia em dias;
• o tipo de nota fiscal que será emitida para as vendas associadas a ele.

1. Após escolher o tipo de nota, clique no ícone de engrenagem para fazer a configuração, caso isso não tenha sido feito automaticamente.
2. Se o tipo de nota for NFS-e, preencha os campos apresentados e clique na seta logo abaixo para retornar à tela anterior.
3. Se o tipo de nota for NF-e, preencha os campos obrigatórios indicados.
4. Clique em Confirmar.
5. Clique em Confirmar novamente.
6. Clique em Visualizar meus dados para verificar como ficou a configuração da sua integração.

Ao finalizar a configuração, todas as vendas realizadas na Stripe sem o nome do produto terão as notas emitidas com o produto padrão selecionado.

Importante:

A não configuração do produto padrão poderá impedir a importação de vendas para o seu painel, pois não será possível importar as vendas que não possuem um produto associado.

A configuração de metadados é adicional e não obrigatória e permite personalizar algumas informações utilizadas para a emissão das notas fiscais.

Para que as informações das vendas feitas através da integração com a Stripe cheguem ao eNotas, é preciso configurar os metadados na API da Stripe.

Documentação API Stripe - Metadata

Siga os passos abaixo para realizar essa configuração:

1. Acesse sua conta da Stripe e faça login.
2. Clique na aba "Clientes".
3. Na coluna à esquerda, vá em "Metadados" e clique em "Editar".
4. Insira os campos que o cliente deverá preencher no checkout da venda e que deverão ser utilizados pelo eNotas.

Exemplos de campos:

• user_cidade: cidade do cliente
• user_nome: nome completo do cliente
• user_cep: CEP do cliente
• user_cpf: documento do cliente
• user_bairro: bairro do cliente
• user_numero: número do endereço do cliente
• user_fone: telefone do cliente
• user_estado: estado do cliente
• user_rua: rua do cliente

1. Repita no eNotas exatamente os mesmos campos parametrizados na Stripe, para que as informações sejam importadas corretamente para o seu painel.
2. Faça login em sua conta no eNotas.
3. Vá em "Gerenciar > Apps".
4. Localize a integração com a Stripe e clique em "Editar".
5. Em "Nenhum metadado configurado", clique em "Alterar".
6. Configure os dados conforme as informações no JSON no ambiente da Stripe.
7. Utilize os símbolos de + para adicionar e - para remover os campos, conforme necessário.
8. Clique em "Confirmar".

Após realizar as configurações, todas as novas vendas realizadas entrarão no eNotas com os dados de metadados enviados da Stripe.

Para validar se o metadado está chegando corretamente em uma venda, siga os passos abaixo:

• No painel de vendas do eNotas, clique na venda desejada.
• Dentro da venda, clique no ícone de relógio, referente ao histórico.
• Localize no histórico a chegada da venda ao eNotas.

• Clique no ícone indicado para verificar os dados recebidos.

Assim, você poderá confirmar se o metadado está chegando corretamente, conforme a configuração realizada.

Você deve acessar a sua conta na Stripe, entrar em Desenvolvedores, abrir a área de Chaves da API e criar uma chave secreta.

Você deve acessar Gerenciar > Apps, localizar a Stripe, clicar em Ativar e informar a chave secreta gerada na Stripe.

Durante a configuração da integração, você pode escolher se a emissão acontecerá no momento da criação da venda no eNotas ou após o período de garantia informado.

Durante a ativação da integração, você pode informar se deseja que as notas sejam encaminhadas automaticamente para o e-mail dos clientes.

A configuração do produto padrão é importante porque a ausência dela pode impedir a importação de vendas para o painel, já que não será possível importar vendas que não possuem um produto associado.

Você deve configurar um produto padrão no eNotas para que essas vendas possam ser utilizadas na emissão das notas.

Ao final da configuração, você pode clicar em Visualizar meus dados para revisar como a integração ficou cadastrada.

Caso o seu plano permita a realização de importação de vendas antigas ou então deseje realizar o upgrade para seguir com a importação, informe ao agente que está conduzindo o seu atendimento em onboarding, para que prossiga com a importação.

Se você não estiver sendo atendido em onboarding, poderá solicitar por aqui.

Informe o período desejado para importação.

Exemplo: De 01/01/2026 a 01/02/2026.