Gateway de pagamento em Portugal: como escolher e integrar

Comece por definir o que precisa de contratar

O termo gateway de pagamento é usado para diferentes combinações de serviços. Pode designar a ligação técnica, uma página de pagamento alojada ou um produto mais abrangente de um prestador. Por isso, descreva primeiro o seu percurso de venda: onde nasce a encomenda, quem calcula o valor, onde o comprador paga e como a sua equipa recebe a confirmação.

Um prestador de serviços de pagamento, ou PSP, disponibiliza serviços sujeitos ao contrato e às capacidades da conta aprovada. Um software de orquestração organiza ligações entre a aplicação e os PSP compatíveis. A distinção interessa quando surge um problema: uma alteração de integração, uma questão sobre um pagamento e uma dúvida sobre um crédito bancário podem ter responsáveis diferentes.

Conhecer a orquestração de pagamentos

Valide a empresa, as moedas e os métodos em Portugal

Prepare uma lista com o país da entidade, a atividade comercial, os mercados dos clientes e as moedas necessárias. Peça a confirmação das condições ao prestador antes de investir na implementação. A disponibilidade de um produto num site internacional não garante a aprovação da sua empresa nem a ativação de todos os métodos anunciados.

Se precisa de um método local específico, trate-o como requisito explícito e confirme também a sua disponibilidade na integração escolhida. Um método existir no catálogo do PSP não significa que esteja implementado em qualquer conector ou módulo. Esta verificação deve ser feita para a conta real, o ambiente e o percurso que pretende lançar, evitando generalizações baseadas apenas no mercado português.

Consultar ligações a prestadores

Escolha entre módulo, API e ligação de pagamento

Numa loja criada sobre uma plataforma de comércio eletrónico, um módulo compatível pode reduzir trabalho de integração. Numa aplicação própria, uma API permite organizar a criação e o acompanhamento dos pagamentos no seu fluxo. Para pedidos pontuais, uma ligação de pagamento pode oferecer um percurso mais simples. Compare estas opções a partir da operação que precisa de realizar.

A documentação da Mollie apresenta integrações com plataformas e um fluxo por API que cria o pagamento, encaminha o cliente e acompanha o resultado. A Stripe documenta Payment Links com uma página alojada para receber o comprador. São exemplos de abordagens disponíveis, não garantias de adequação à sua empresa. Confirme as funcionalidades e condições aplicáveis diretamente com o respetivo prestador.

Explorar ligações de pagamento

Crie a encomenda antes de interpretar o pagamento

Imagine uma empresa de serviços que recebe um pedido com preço definido. O seu servidor valida o valor e a moeda, cria uma referência de encomenda e solicita o pagamento. Guarde a referência devolvida pelo sistema de pagamentos junto da encomenda. Essa relação permite investigar uma operação sem depender de descrições livres ou de capturas de ecrã enviadas pelo cliente.

Distinga os estados comerciais dos estados técnicos. Uma encomenda criada ainda não está paga; uma página aberta não demonstra uma tentativa concluída. Defina quais os estados que permitem preparar, entregar ou ativar o serviço. Se várias equipas consultam a operação, use a mesma regra para evitar que o apoio ao cliente e a aplicação interpretem o mesmo resultado de maneiras diferentes.

Confirme o resultado no servidor

O regresso do comprador ao seu site ajuda a explicar os próximos passos, mas não deve ser a única prova de pagamento. O cliente pode fechar a janela depois de concluir a operação, ou regressar antes de chegar uma notificação. A aplicação precisa de um resultado verificado no servidor para decidir se deve cumprir a encomenda.

A Mollie documenta a consulta do estado após a notificação e a possibilidade de o redirecionamento acontecer primeiro. Desenhe uma página de espera quando o resultado ainda não estiver confirmado e permita recuperar o estado. Não incentive uma segunda compra apenas porque houve um atraso. Um resultado desconhecido precisa de investigação, não de uma suposição automática de falha.

Prepare webhooks e pedidos repetidos

As notificações por webhook ligam o resultado do pagamento à sua aplicação. Verifique a assinatura segundo o protocolo documentado e prepare o tratamento de eventos repetidos. A documentação da Stripe aborda estes dois aspetos. O objetivo é que uma nova entrega da mesma informação não origine uma segunda expedição, uma nova ativação ou outra ação comercial duplicada.

Para pedidos de criação sujeitos a interrupções de rede, utilize os mecanismos de idempotência previstos na integração. Mantenha uma referência estável para a intenção comercial e distinga uma repetição técnica de uma nova venda. Durante a avaliação, teste estes casos com a equipa técnica: são mais reveladores da robustez do processo do que uma demonstração em que tudo corre bem.

Perceba onde entra a OrsunPay

A OrsunPay é software de orquestração de pagamentos, com uma API comum, estados consistentes e webhooks assinados para as operações suportadas. O comerciante mantém os seus contratos e contas nos PSP. Os fundos são liquidados diretamente pelo prestador, enquanto a utilização do software OrsunPay é faturada separadamente. A ligação técnica não substitui a abertura ou aprovação de uma conta comercial.

O catálogo inclui implementações para prestadores como Stripe, Adyen e Mollie. Confirme, contudo, a matriz de capacidades da ligação concreta. A oferta atual usa a ligação configurada ou os métodos elegíveis no checkout alojado; não inclui cascatas automáticas nem encaminhamento para otimização de custos. A sua avaliação deve incidir nas funções disponíveis, sem deduzir melhorias de aceitação ou de comissões.

Inclua idioma e operação diária nos requisitos

Para um público em Portugal, verifique o idioma em todas as etapas: pedido, página de pagamento, mensagens e apoio. O idioma do site comercial de um fornecedor não prova que o seu checkout tenha a mesma tradução. No caso dos percursos de ligação de pagamento da OrsunPay, a interface alojada atual está disponível em inglês e ucraniano; confirme a adequação antes de a escolher.

Pergunte também quem pode criar ou desativar ligações, consultar operações e alterar configurações. As ligações OrsunPay trabalham com valor e moeda definidos, e a gestão pelo painel está atualmente disponível para operações reais. Abrir ou pré-visualizar uma ligação não cria, por si só, um pagamento. Estes detalhes devem ficar claros no procedimento interno da equipa.

Compare custos e prepare o acompanhamento financeiro

Avalie os custos com uma hipótese comum de volume, moedas e meios de pagamento. Considere as condições do PSP, a manutenção da integração, o trabalho de apoio e eventuais custos de software. No caso da OrsunPay, a taxa de software é adicional aos custos dos seus prestadores. Não reduza a comparação a um valor anunciado sem verificar o que inclui.

Guarde as referências que permitem relacionar encomenda, pagamento e documentação do PSP. Um estado técnico comum ajuda a aplicação, mas não substitui a explicação de um montante recebido no banco. Defina ainda o processo de reembolso suportado e quem o executa. Não pressuponha que todas as operações de todos os prestadores estão disponíveis através de uma camada comum.

Faça um piloto com critérios de decisão

Escolha uma venda representativa e registe os resultados esperados: criação única, valor correto, confirmação independente do navegador, repetição segura de notificações e recuperação de falhas. Acrescente um caso em que o cliente pede ajuda e a equipa precisa de encontrar o pagamento. O piloto deve validar o ciclo completo, incluindo as exceções e os responsáveis por cada uma.

Uma ligação direta pode ser suficiente para um único prestador e um processo simples. Se várias contas exigem integrações e procedimentos separados, uma camada de orquestração merece avaliação. Para discutir a OrsunPay, leve um exemplo de encomenda, os PSP aprovados e os métodos necessários. A melhor escolha será aquela cujo comportamento e esforço de operação consegue demonstrar no seu contexto.

Fontes

• Mollie: aceitar pagamentos
• Stripe Payment Links
• Stripe: documentação de webhooks