Como integrar o InvoiceXpress com o Stripe

Com o plugin de integração com o Stripe que disponibilizamos pode gerar automaticamente faturas para cada pagamento que recebe dos seus clientes através desta plataforma de pagamentos online.

A configuração da integração da sua conta Stripe com a sua conta do programa de faturação InvoiceXpress é bastante simples, mas requer alguns passos que tem de realizar obrigatoriamente. Para o ajudar a usufruir deste plugin de integração para a sua faturação, elaborámos um passo a passo para configurar esta solução.

Configuração necessária na sua conta Stripe:

1. Inicie sessão na sua conta do Stripe (ou crie uma nova conta, caso necessário);
2. Entre na ‘Dashboard’ da sua conta Stripe;
3. De seguida, entre na página ‘Developers’ situada no menu superior no Stripe;
4. Já dentro do menu de Developers, ao lado da página de ‘Overview’ deve clicar em ‘API keys’;
5. É dentro desta página de API keys que vai encontrar a chave que precisa copiar para a sua conta no InvoiceXpress de modo a configurar a integração: a ‘Secret key’ - caso nunca tenha criado uma Secret key anteriormente na sua conta Stripe, vai encontrar à direita na área de ‘Standard keys’ o botão “+ Create Secret key” que lhe permite criar uma Secret key.
6. Na área da Secret key, depois de a ter criado, clique no ícone que aparece junto à chave (ver imagem exemplo abaixo) ‘Reveal live key’ e clique também em cima desta chave para a copiar e passar para o InvoiceXpress.

Configuração necessária na sua conta InvoiceXpress:

1. Tendo assegurado então que já tem a chave na sua conta Stripe, entre na sua conta do programa de faturação InvoiceXpress e vá ao seu menu de ‘Preferências de Conta’;
2. No menu de Preferências de Conta selecione ‘Integrações’;

3. De seguida, nesta nova página de Integrações do InvoiceXpress, vai encontrar o Stripe na lista de ‘Plugins disponíveis’, selecione-o;

   Vai entrar na página de configuração do Stripe no InvoiceXpress. É aqui que deve:

4. 1. Dar o nome que pretende a esta integração (serve apenas para identificar a integração que está a fazer com a sua conta Stripe);
   2. Acrescentar alguma descrição a esta integração (este campo não é obrigatório - serve apenas caso queira colocar alguma observação ou alguma nota sobre a integração com a sua conta Stripe);
   3. Copiar a ‘Secret key’ da sua conta no Stripe e introduzí-la no campo ‘Secret Key’. Ao introduzir a Secret key o plugin irá gerar automaticamente um Webhook (um sistema de notificações automático usado para integrações entre diferentes serviços), e esse Webhook ficará automaticamente preenchido na página de configuração do plugin.
   4. Preencher as "Configurações externas" - pode ativar as opções de enviar automaticamente a fatura para o email do contacto, e a opção de emitir Nota de Crédito automaticamente no InovoiceXpress quando um reembolso é feito no Stripe.
   5. Definir a taxa de IVA que quer aplicar às faturas que vai gerar automaticamente dos pagamentos do Stripe no campo ‘IVA %’;
   6. E, finalmente, e apenas caso tenha selecionado ‘Isento’ no campo do IVA, escolher qual a sua razão de Isenção de IVA.
5. Introduzidos todos os dados, clique em ‘Guardar e Continuar’.

6. Por último, deve ter uma chave API gerada para o seu utilizador do InvoiceXpress. Este é um passo crucial, sem o qual a integração com o Stripe não irá funcionar. Para gerar uma chave API, entre nas configurações da conta InvoiceXpress (ícone no canto superior direito) e aceda a Preferências da Conta > API. Caso já exista uma chave API gerada para o seu utilizador não precisará de criar uma nova, caso não exista clique em Gerar chave:

   

Concluídos estes passos, a integração entre a sua conta do programa de faturação InvoiceXpress e a sua conta na plataforma de pagamentos Stripe fica configurada e ativa.

Na mesma página de ‘Integrações’ no InvoiceXpress, em baixo, no separador de ‘Lista de Integrações Ativas’, já lhe irá aparecer a integração ativa do Stripe, a qual pode voltar a editar configurações ou ver documentos emitidos diretamente.

Os documentos emitidos no InvoiceXpress via esta integração de faturação com o Stripe serão sempre, por omissão, faturas-recibo, que ficarão no estado "Pago".

Se utiliza o Stripe para receber pagamentos dos seus clientes, queremos ainda destacar que é importante que tenha uma campo de NIF disponível no ecrã de pagamentos/página de carrinho do seu site ou loja online do seu negócio, de modo a que essa informação seja comunicada através desta solução de integração com o InvoiceXpress, e as suas faturas contenham também elas esse campo fiscal.