Saltar para o conteúdo
Tejobit

Pagamentos

Integração PayPal

Liga os webhooks e a API de transações do PayPal à faturação e à loja, para capturas, reembolsos e disputas não ficarem por registar.

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

Visão geral

PayPal

O PayPal continua a ser o método preferido de muitos compradores estrangeiros, sobretudo em vendas para o Reino Unido, Alemanha ou Estados Unidos. Para quem vende, o problema raramente é receber: é registar tudo direito do lado português.

A Tejobit liga a API de Orders e os webhooks do PayPal ao sistema da empresa. Quando uma captura fica concluída, a encomenda avança e o programa de faturação emite o documento; quando há um reembolso, sai a nota de crédito; quando um comprador abre uma disputa, alguém é avisado no próprio dia.

No fim do mês, a ligação usa a pesquisa de transações para cruzar o saldo PayPal com as faturas emitidas, incluindo as comissões cobradas.

Casos de uso

Para que serve

  • Artesão ou loja de nicho que vende para fora através do PayPal e precisa de faturas certificadas
  • Escola de surf ou operador turístico que recebe reservas de estrangeiros por PayPal
  • Loja WooCommerce com PayPal no checkout e vendas a acertar com a contabilidade
  • Criador digital que vende ficheiros e quer o envio do produto e da fatura automáticos
IN

O que a ligação escuta

  • PAYMENT.CAPTURE.COMPLETED quando o dinheiro fica capturado
  • CHECKOUT.ORDER.APPROVED em fluxos de checkout próprios
  • PAYMENT.CAPTURE.REFUNDED e PAYMENT.CAPTURE.REVERSED
  • CUSTOMER.DISPUTE.CREATED quando um comprador abre um caso
  • Pesquisa periódica de transações para reconciliação
OUT

O que a ligação faz

  • Capturar ordens aprovadas pela API de Orders
  • Emitir fatura ou nota de crédito no programa de faturação
  • Atualizar o estado da encomenda na loja ou no back-office
  • Registar comissões e líquido recebido para a contabilidade
  • Avisar a equipa de disputas com o prazo de resposta

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 PayPal Business e uma app REST criada no PayPal Developer
  • Client ID e secret da app, e o webhook registado com os eventos necessários
  • Regras de faturação para clientes estrangeiros e para consumidores finais
  • Acesso à loja e ao programa de faturação

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 pesquisa de transações tem atraso de algumas horas e devolve no máximo 31 dias por pedido
  • Os pagamentos com eCheck ou retidos para revisão demoram dias a ficar concluídos
  • O PayPal não emite faturas certificadas pela AT; o programa de faturação faz esse papel

Perguntas frequentes

Antes de começar

As comissões do PayPal entram na contabilidade?

Sim. Cada transação traz o valor bruto, a comissão e o líquido. A ligação regista os três, para a contabilidade ter o custo da comissão separado da venda.

Vendo para fora da UE. A fatura muda?

A ligação passa ao programa de faturação o país e os dados do cliente, e a regra de IVA aplicada é a que estiver configurada nesse programa para exportações e vendas intracomunitárias.

Quanto tempo tenho para responder a uma disputa?

O PayPal define um prazo por caso. A ligação envia o aviso com a data limite logo que a disputa é criada, para não se perder o prazo.

Integrações relacionadas

Ver todas as integrações

Ativar a integração PayPal?

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