Back to Integrations

Integração Stripe

Documentação técnica da integração Stripe, incluindo eventos suportados, fluxos de pagamento e automação de faturação com os Integradores Kapta.

Integração Stripe

Visão geral

A integração Stripe liga eventos de pagamento e faturação aos Integradores Kapta, permitindo fluxos de trabalho automatizados para faturação, subscrições e operações financeiras.

Esta integração é normalmente utilizada para sincronizar pagamentos com software de contabilidade, gerir o ciclo de vida das subscrições e desencadear processos financeiros subsequentes sem intervenção manual.

Casos de uso típicos

  • Criação automática de faturas quando uma reserva é confirmada
  • Sincronização de dados de clientes e reservas com sistemas de faturação
  • Propagação do estado dos pagamentos para ferramentas operacionais
  • Notificações internas para eventos do ciclo de vida das reservas

Eventos suportados

Estes eventos são emitidos pela Stripe e consumidos pela Kapta para desencadear fluxos de trabalho automatizados.

A integração escuta os seguintes eventos da Stripe:

  • Pagamento bem sucedido
  • Pagamento falhado
  • Fatura criada
  • Fatura paga
  • Subscrição criada
  • Subscrição actualizada
  • Subscrição cancelada

Fluxo de dados

A integração segue um pipeline de processamento de eventos previsível e auditável.

  1. A Stripe emite um evento
  2. A Kapta recebe e valida o payload
  3. Os dados são normalizados e mapeados para modelos internos
  4. Os fluxos de trabalho são executados com base em regras configuradas
  5. Estados e identificadores são sincronizados entre sistemas

Comportamento de faturação e pagamentos

Quando as integrações de faturação estão activas, a Kapta pode:

  • Criar faturas automaticamente aquando da confirmação da reserva
  • Actualizar o estado das faturas quando os pagamentos são concluídos ou reembolsados
  • Gerir pagamentos parciais e reembolsos
  • Manter referências entre reservas e documentos de faturação

Configuração

As integrações são configuradas uma única vez e mantidas centralmente pela Kapta.

A configuração é assegurada pela equipa da Kapta e inclui normalmente:

  • Configuração de credenciais de API
  • Selecção e filtragem de eventos
  • Mapeamento de dados entre a Stripe e os sistemas de destino
  • Definição de regras para faturação e activação de fluxos de trabalho

Não é necessário qualquer desenvolvimento do lado do cliente.

Aplicação Stripe Marketplace

A Kapta disponibiliza também uma aplicação nativa no Stripe Marketplace para utilizadores do InvoiceXpress. Isto permite uma configuração mais rápida directamente a partir da Stripe e mantém a configuração alinhada com as boas práticas da Stripe.

Ver a Kapta no Stripe Marketplace

Limitações

  • A entrega de eventos depende da disponibilidade dos webhooks da Stripe
  • Dados históricos podem exigir um processo de importação ou reconciliação separado
  • Algumas funcionalidades avançadas da Stripe podem exigir configuração adicional

Segurança e conformidade

Todos os dados são transmitidos de forma segura através de ligações encriptadas. O acesso é restrito a sistemas autorizados e as credenciais são armazenadas de forma segura.

Os dados de faturação e pagamentos são tratados em conformidade com os requisitos portugueses e da União Europeia, sempre que aplicável.

Perguntas frequentes

Esta integração suporta múltiplas contas Stripe?

Sim. Podem ser ligadas múltiplas contas Stripe e isoladas por integração.

Os fluxos de trabalho podem ser personalizados por produto ou actividade?

Sim. Podem ser definidas regras com base em atributos da reserva, produtos ou estado do pagamento.

É suportado processamento em tempo real?

Sim. Os eventos são processados quase em tempo real, dependendo da entrega pela Stripe.


Precisa de ajuda ou alterações?

Esta integração é gerida pela equipa da Kapta. Se precisar de ajustes, eventos adicionais ou regras de faturação, contacte o suporte para discutir os seus requisitos.

Ready to connect this integration

Start your setup in a few minutes and automate your workflows.

Integrações de Sistemas e Automação pela Kapta