Saltar para o conteúdo
Tejobit

Pagamentos

Integração Stripe

Leva cada pagamento, subscrição e reembolso da Stripe para a faturação portuguesa, o CRM e o back-office, sem exportações.

Pedir esta integração Ver todas as integrações

Visão geral

Stripe

A Stripe é a plataforma de pagamentos de muitas startups, SaaS e lojas com clientes fora de Portugal. Trata de cartões, carteiras digitais, subscrições e, em Portugal, também de Multibanco e MB WAY através dos métodos de pagamento locais.

O problema habitual é a faturação: a Stripe gera recibos, mas não emite faturas certificadas pela AT. A Tejobit liga os webhooks da Stripe ao programa de faturação, para que cada pagamento ou renovação de subscrição dê origem ao documento certo, com o NIF do cliente quando existe.

A mesma ligação pode atualizar o CRM com o estado da subscrição, avisar a equipa de uma disputa ou preencher uma folha de receitas por mês, a partir dos mesmos eventos.

Casos de uso

Para que serve

  • SaaS português com subscrições na Stripe e faturas certificadas emitidas a cada renovação
  • Formador ou criador de cursos que vende pelo Stripe Checkout e quer a fatura enviada sozinha
  • Coworking que cobra planos mensais e marca no CRM quem tem o pagamento em falta
  • Loja com clientes internacionais que precisa de reconciliar pagamentos e transferências da Stripe
  • Empresa de eventos que trata reembolsos e notas de crédito no mesmo fluxo
IN

O que a ligação escuta

  • checkout.session.completed quando um cliente conclui o pagamento
  • invoice.paid e invoice.payment_failed nas subscrições
  • payment_intent.succeeded em pagamentos feitos por API
  • charge.refunded e charge.dispute.created
  • customer.subscription.updated e customer.subscription.deleted
OUT

O que a ligação faz

  • Emitir a fatura-recibo no programa de faturação, com os dados fiscais do cliente
  • Criar a nota de crédito quando há um reembolso
  • Atualizar o estado da subscrição no CRM ou no back-office
  • Avisar a equipa no Slack ou por email quando há uma disputa
  • Registar pagamentos, comissões e transferências numa folha para a contabilidade

Como funciona

Do pedido à ligação em funcionamento

  1. 01

    Pedido

    O formulário indica a integração, as ferramentas envolvidas e o que deve acontecer em cada caso.

  2. 02

    Análise e proposta

    A Tejobit confirma o que a API permite e envia uma proposta com o fluxo, o preço e o prazo.

  3. 03

    Configuração e testes

    A ligação é configurada com as contas do negócio e testada com casos reais antes de ficar ativa.

  4. 04

    Manutenção e monitorização

    A Tejobit aloja a ligação, acompanha os erros e adapta-a quando a API muda.

A ligação corre na infraestrutura da Tejobit. A mensalidade cobre o alojamento, a monitorização e as alterações da API.

O que é preciso preparar

  • Conta Stripe e uma chave restrita com as permissões necessárias
  • Endpoint de webhook criado e o segredo de assinatura partilhado
  • Onde está guardado o NIF do cliente (campo de checkout, metadados ou CRM)
  • Acesso ao programa de faturação e as séries a usar

Por segurança, não envie passwords, chaves API ou tokens pelo formulário. As credenciais são pedidas por um canal seguro quando a configuração começa.

Limites

  • A Stripe não emite faturas certificadas em Portugal; esse papel é do programa de faturação
  • Os webhooks podem chegar repetidos ou fora de ordem, e a ligação tem de os tratar sem duplicar documentos
  • Algumas permissões e métodos de pagamento dependem da conta e do país

Perguntas frequentes

Antes de começar

Porque não basta o recibo da Stripe?

Em Portugal, a fatura tem de ser emitida por um programa certificado e comunicada à AT. O recibo da Stripe serve de comprovativo ao cliente, mas não substitui a fatura.

E se o mesmo evento chegar duas vezes?

A ligação guarda o identificador de cada evento já tratado e ignora repetições, por isso nunca sai uma fatura em duplicado.

Funciona com o Stripe Billing e com pagamentos avulsos?

Sim. As subscrições usam os eventos de invoice e os pagamentos avulsos usam checkout.session.completed ou payment_intent.succeeded, cada um com as suas regras.

Posso usar a Stripe com clientes empresa e particulares?

Sim. Com NIF, a fatura sai em nome da empresa; sem NIF, sai como consumidor final, segundo a regra definida para cada caso.

Integrações relacionadas

Ver todas as integrações

Ativar a integração Stripe?

Descreva o que deve passar entre as ferramentas. A resposta confirma a viabilidade, o preço e o prazo.

Fale sobre o projeto geral@tejobit.com