Como ligar Stripe ao InvoiceXpress em menos tempo
Guia prático para configurar o LusoInvoice, validar credenciais e iniciar emissão de documentos portugueses a partir do Stripe Dashboard.
Pré-requisitos antes da integração
Antes de iniciar, confirme que tem acesso administrativo ao Stripe e ao InvoiceXpress. Esta validação inicial evita interrupções durante o onboarding.
Também deve confirmar o tipo de documento que vai emitir por defeito e se a série no InvoiceXpress está ativa para emissão.
- Conta Stripe com permissões para instalar aplicações.
- Conta InvoiceXpress com API key ativa.
- Definições fiscais mínimas (IVA, isenções e retenções) já definidas.
Passo a passo de configuração
Instale o LusoInvoice no Stripe App Marketplace e abra o painel da aplicação no Dashboard. Em seguida, introduza subdomínio e API key do InvoiceXpress.
Depois de validar credenciais, ative o webhook de sincronização automática e configure regras de emissão (tipo de documento, série, IVA e comportamento automático).
- Validar credenciais com o botão "Validar e Continuar".
- Ativar integração webhook para eventos de pagamento concluído.
- Rever definições para garantir compatibilidade com o seu processo atual.
Checklist de qualidade após a ligação
Faça um teste com um pagamento em modo de teste no Stripe para confirmar criação correta de documento e ligação ao cliente.
Acompanhe os logs de sincronização nas primeiras operações para identificar rapidamente divergências de IVA, séries ou associação de cliente.
- Confirmar que não existem documentos duplicados para o mesmo pagamento.
- Validar valores líquidos, IVA e total no documento emitido.
- Garantir que o cliente Stripe está associado ao cliente correto no InvoiceXpress.
FAQ rápida
Posso começar com sincronização manual?
Sim. Pode instalar e usar criação manual de documentos antes de ativar o modo automático via webhook.
Preciso de alterar algo no meu Stripe Checkout?
Na maioria dos casos não. Apenas deve garantir que os dados fiscais e de cliente usados no pagamento estão completos.