Visão geral
A integração PayPal liga eventos de pagamento e reembolso aos Integradores Kapta, permitindo fluxos de trabalho automatizados de faturação, reconciliação e operações.
Esta integração é normalmente utilizada para sincronizar pagamentos PayPal com sistemas de faturação, actualizar o estado das transacções e desencadear processos financeiros subsequentes sem intervenção manual.
Casos de uso típicos
- Criação automática de faturas quando um pagamento PayPal é confirmado
- Sincronização de dados de pagamento e do pagador com sistemas de faturação
- Propagação do estado de pagamentos e reembolsos para ferramentas contabilísticas e operacionais
- Notificações internas para eventos do ciclo de vida dos pagamentos
Eventos suportados
Estes eventos são emitidos pelo PayPal e consumidos pela Kapta para desencadear fluxos de trabalho automatizados.
A integração escuta os seguintes eventos do PayPal:
- Pagamento concluído
- Pagamento recusado ou falhado
- Reembolso processado
- Disputa aberta
- Disputa resolvida
Fluxo de dados
A integração segue um pipeline de processamento de eventos previsível e auditável.
- O PayPal emite um evento
- A Kapta recebe e valida o payload
- Os dados são normalizados e mapeados para modelos internos
- Os fluxos de trabalho são executados com base em regras configuradas
- 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 quando um pagamento é confirmado
- Actualizar o estado das faturas com base em eventos de pagamento, reembolso ou disputa
- Gerir reembolsos parciais e chargebacks
- Manter referências entre transacções PayPal 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 o PayPal 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.
Limitações
- A entrega de eventos depende da disponibilidade dos webhooks do PayPal
- Algumas disputas podem ter resolução atrasada
- Transacções históricas podem exigir um processo de reconciliação separado
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 PayPal?
Sim. Podem ser ligadas múltiplas contas PayPal 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 pelo PayPal.
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.

