> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://ajuda.spedy.com.br/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Como habilitar a integração com a Stripe?

O [Stripe](https://stripe.com/br) é uma plataforma de pagamentos para a web, podendo ser adicionada como gateway em qualquer site, especialmente em sistemas CMS, como o WordPress. A função dessa ferramenta é receber pagamentos, transferências, doações e qualquer tipo de transação financeira que seja comum a e-commerces ou a qualquer tipo de site da web.

${youtube}[Integração Stripe](P5-qyIRd2HY?si=jEe3uzUO9XXhcqBU)

# Habilitando a integração

Após logar em sua conta na Spedy, clique em Apps no menu lateral e, no card da Stripe, clique no botão Desabilitado ou no botão Mais Ações (três pontos) > + Nova Integração.

![](https://storage.crisp.chat/users/helpdesk/website/90629981fbf4980/str1_1iu5h7f.png)

Na tela exibida, o botão **Habilitar integração** já estará ativado.

![](https://storage.crisp.chat/users/helpdesk/website/90629981fbf4980/str2_u4b9fh.png)

Em **Qual modelo de nota fiscal?** será definido o modelo de nota fiscal que será utilizado por padrão nas vendas. Se precisar, você poderá modificar o modelo de forma específica no cadastro do produto.

A opção **Quando emitir a nota fiscal**? definirá em que momento a nota fiscal será emitida para as vendas integradas:

|| Antes de habilitar a emissão automática é necessário emitir uma nota fiscal para validação. Por isso, ao habilitar a integração, por padrão, as vendas serão integradas com o modo de emissão **Não emitir automaticamente**. Posteriormente, após validar a emissão de nota, será possível habilitar a emissão automática.

* **Na geração da venda**: A venda será integrada logo após geração na plataforma de vendas, mesmo sem a aprovação do pagamento e a nota fiscal será emitida automaticamente;
* **Emitir após o período de garantia:** A nota será emitida automaticamente após o período de garantia da venda;
* **Emitir quando o pagamento for aprovado:** A nota será emitida automaticamente após a aprovação do pagamento da venda;
* **Não emitir automaticamente:** A nota deverá ser emitida manualmente na tela de vendas.

|| Homologada a emissão de nota fiscal, se for preciso importar vendas retroativas, selecione a opção **Não emitir automaticamente**, para evitar a emissão de nota fiscal em competência indevida. Após a integração das vendas retroativas, habilite novamente a emissão automática conforme preferência.

A opção **Enviar nota fiscal via email para o cliente?** define se, após autorização da nota, ela será ou não enviada via e-mail ao cliente.

Já a opção **Cancelar nota fiscal quando houver um reembolso?** define se a nota será ou não cancelada automaticamente quando houve aprovação de reembolso para a venda.

Agora, acesse sua conta na Stripe e clique na opção [Desenvolvedores](https://dashboard.stripe.com/developers) no dashboard.

Clique no menu **Chaves da API**, copie o token da Chave publicável e cole no respectivo parâmetro na tela de configuração de integração da Stripe na Spedy.

![](https://storage.crisp.chat/users/helpdesk/website/f5ccad36f5afe000/643ee0a1-a562-456c-9624-831a97_naiasy.png)

![](https://storage.crisp.chat/users/helpdesk/website/90629981fbf4980/str3_1f73lrt.png)

Continuando, clique no botão **+** **Criar chave secreta**. Na tela exibida, informe o nome Spedy e clique em Criar.

![](https://storage.crisp.chat/users/helpdesk/website/26d446e9d8951400/c039148a-51e0-424d-95ca-9fddbc_1qxyjbg.png)

Copie a chave secreta gerada e cole no respectivo parâmetro na tela de configurações do app da Stripe na Spedy.

![](https://storage.crisp.chat/users/helpdesk/website/90629981fbf4980/str4_1l39p1h.png)

Para concluir, iremos informar qual a data de início da integração, o código do produto padrão e a quantidade de dias de garantia (caso se trabalhe com a emissão das notas Após o período de garantia). 

No campo **Data de início da integração**, deve-se informar a data a partir da qual o sistema deverá importar as vendas. Este campo é utilizado quando existem vendas retroativas a serem integradas.

Por exemplo: a integração está sendo realizada no dia 07/07/2023. Contudo, existem vendas realizadas desde 01/07/2023. Logo, deverá ser informada a data 01/07/2023 para que as vendas retroativas sejam integradas.

|| Este campo está disponível somente a partir do **Plano Essencial**. No plano Iniciante, serão importadas somente as vendas geradas após a conclusão da integração da Spedy com a Stripe.

No campo **Código do produto padrão**, informe o código do produto cadastrado na Spedy que será utilizado para integrar uma fatura que foi lançada sem uma descrição. 
Caso não tenha um produto padrão, deixe o campo sem preenchimento.

Se for trabalhar com a emissão automática da nota fiscal **Após o período de garantia**, no campo **Dias de garantia**, deverá ser informada a quantidade de dias de garantia. Informando os dias de garantia, o campo Data de garantia será preenchido na venda e a nota fiscal será emitida automaticamente após o período da garantia.

Clique em Salvar para concluir a configuração da integração da Spedy com a Stripe.

## CPF ou CNPJ nas vendas da Stripe

A integração utiliza os dados enviados pela Stripe. Para que o documento seja preenchido no campo `federalTaxNumber` da nota, informe o CPF ou CNPJ em um campo personalizado (`custom_fields`) do checkout com um destes nomes: `cpf`, `cnpj`, `cpfcnpj` ou `cnpjcpf`. O restante das informações do cliente é obtido do objeto padrão `customer_details` da Stripe.

Se o documento não for enviado pela Stripe, ele não será incluído automaticamente na venda importada. Nesse caso, corrija o cadastro do cliente na Spedy para as vendas já importadas e ajuste também o cadastro na Stripe para que as próximas vendas recorrentes recebam o CPF/CNPJ correto. A alteração na Stripe não atualiza retroativamente vendas que já estão na Spedy.

A ausência do documento pode impedir a autorização da NFS-e quando o provedor ou a prefeitura exigir o CPF/CNPJ do tomador. Para NF-e de produto, o CPF/CNPJ do comprador é obrigatório; para NFS-e, a exigência depende da prefeitura.

A partir de agora, suas vendas na Stripe começarão a aparecer no painel de vendas da Spedy automaticamente.

Viu como é simples e fácil utilizar nossa plataforma? Cuidamos de suas notas fiscais para que você foque no crescimento do seu negócio.

Caso ainda tenha alguma dúvida, entre em contato conosco através de um de nossos canais de atendimento.

Até mais. :)  