O Que É um Gateway de Pagamento? Como Funcionam os Pagamentos Online

Um gateway de pagamento é o serviço que recolhe com segurança os dados de pagamento do cliente no checkout, os envia aos bancos e às redes de cartões para aprovação, e devolve "aprovado" ou "recusado" — normalmente em poucos segundos. É a ponte entre a sua app e o sistema financeiro. A Stripe, a PayPal, a Adyen, a Square e a Braintree são exemplos conhecidos.

Hoje, a maioria destas empresas junta o gateway a tudo o que precisa para receber pagamentos, por isso "gateway de pagamento", "processador de pagamentos" e "fornecedor de pagamentos" são muitas vezes usados para dizer o mesmo.

Porque é que os gateways importam quando cria com IA

"Adicionar pagamentos" é um dos pedidos mais comuns que as pessoas fazem aos construtores de IA, e um dos mais fáceis de fazer mal de forma subtil. O código em si costuma ser curto. As partes importantes são as decisões à volta dele:

• Qual o fornecedor que se adapta ao seu negócio, ao seu país e ao que vende.
• Onde o código corre. As chaves secretas de pagamento têm de ficar no servidor, nunca no navegador.
• Como a sua app fica a saber que um pagamento foi bem-sucedido. A forma fiável é um webhook do fornecedor — e não o cliente chegar a uma página de "obrigado".
• As suas responsabilidades legais e fiscais, que dependem de quem é o merchant of record.

Perceber o que faz um gateway ajuda-o a dar instruções claras e a verificar que o resultado é seguro.

Uma analogia do dia a dia

Pense em pagar com cartão numa loja.

O terminal de cartões no balcão é o gateway: lê o seu cartão com segurança e envia o pedido. Não decide nada — passa a pergunta "esta pessoa pode pagar 40 €?" ao longo de uma cadeia até ao seu banco e recebe a resposta. O banco da loja (adquirente) e o seu banco (emissor) é que decidem, através da rede de cartões (Visa, Mastercard) que os liga.

Um gateway de pagamento online é esse terminal, reconstruído para a web — mais a segurança necessária para lidar com dados de cartões que chegam pela internet.

Como funciona um pagamento online com cartão

Eis o que acontece nos segundos após o cliente clicar em "Pagar":

Há dois pontos que vale a pena conhecer:

• Autorização não é o mesmo que ser pago. O dinheiro é primeiro reservado, depois capturado e por fim liquidado na sua conta — muitas vezes dias depois.
• A sua app nunca deve ver o número do cartão. Os fornecedores modernos oferecem uma página de checkout alojada ou campos incorporados que eles controlam, e a sua app recebe apenas uma referência ao pagamento.

As principais peças e quem trata de cada uma

Alguns fornecedores (Paddle, Lemon Squeezy) atuam eles próprios como merchant of record, tratando do IVA e dos impostos sobre as vendas por si, em troca de comissões mais altas. Outros (Stripe, PayPal) deixam-no como merchant of record, com ferramentas fiscais opcionais. Para uma análise justa das opções, veja Stripe vs Paddle vs Lemon Squeezy e Stripe vs PayPal.

Um exemplo prático: vender um curso

Vende um curso online por 99 € e pede ao seu construtor de IA que acrescente um botão "Comprar".

1. O cliente clica em Comprar. O seu servidor usa a chave secreta para pedir ao fornecedor que crie uma sessão de checkout de 99 € e recebe de volta um link.
2. O cliente é enviado para a página de checkout alojada do fornecedor, introduz o cartão e conclui qualquer verificação 3D Secure com o banco.
3. O pagamento é aprovado e o cliente é redirecionado para a sua página de "sucesso".
4. Em separado, o fornecedor envia um webhook ao seu servidor: "pagamento da sessão X concluído com sucesso." O seu servidor verifica a assinatura do webhook, encontra a encomenda, marca-a como paga e desbloqueia o curso.
5. Dias depois, o dinheiro, menos as comissões, chega à sua conta bancária.

O passo 4 é o mais importante. Se desbloquear o curso na página de sucesso, qualquer pessoa que encontrasse esse URL poderia obtê-lo de graça, e os clientes cujo navegador fechasse cedo pagariam e não receberiam nada.

Termos-chave

Equívocos comuns

• "Tenho de guardar os números dos cartões para cobrar os clientes outra vez." Não. Os fornecedores guardam o cartão e dão-lhe um token de referência para cobranças repetidas e subscrições. Nunca deve guardar números de cartões por si próprio.
• "A página de sucesso significa que o pagamento funcionou." Confirme os pagamentos com webhooks no servidor. Os redirecionamentos podem ser contornados, falsificados ou nunca acontecer.
• "Todos os fornecedores de pagamento custam mais ou menos o mesmo." As comissões variam conforme o fornecedor, o país, o tipo de cartão e se o tratamento fiscal está incluído. Consulte a página de preços atual de cada fornecedor para o seu país.
• "Usar a Stripe torna-me conforme com a PCI." Simplifica muito a conformidade, porque os dados do cartão ficam com o fornecedor — mas continua a ter uma autoavaliação (normalmente curta) para preencher.
• "O modo de teste e o modo real comportam-se exatamente da mesma forma." Estão próximos, mas o modo real exige uma conta totalmente verificada, endpoints de webhook configurados para o ambiente real e dados bancários verdadeiros.
• "Um gateway de pagamento trata dos meus impostos." Só se for o merchant of record ou se ativar e configurar as suas funcionalidades fiscais. Verifique as regras locais ou consulte um consultor.

O que pedir ao seu construtor de IA

• "Acrescente o [Stripe] Checkout para [produto]. Crie a sessão no servidor usando a chave secreta de uma variável de ambiente."
• "Marque as encomendas como pagas apenas a partir de um webhook verificado, e confirme a assinatura do webhook."
• "Trate o caso de o webhook ser enviado duas vezes sem criar encomendas duplicadas."
• "Use as chaves do modo de teste e explique-me como testar com os cartões de teste do fornecedor, incluindo um cartão recusado."
• "O que acontece se o cliente fechar o separador depois de pagar?"
• "Mostre-me todos os sítios onde uma chave de pagamento é usada e confirme que a chave secreta nunca chega ao navegador."

Gateways de pagamento na Mythex

A Mythex não inclui pagamentos integrados para as apps que cria, e não existe um botão de um clique "Ligar Stripe". Cria uma conta com o fornecedor escolhido, acrescenta as suas chaves de teste como segredos do projeto e pede ao agente que construa o checkout do lado do servidor. Teste na Pré-visualização com os cartões de teste do fornecedor e depois publique. A documentação explica o processo em Aceitar pagamentos com a Stripe, e Webhooks cobre o passo de confirmação.

Para uma construção passo a passo, veja como acrescentar pagamentos à sua app e, para faturação recorrente, como acrescentar subscrições com a Stripe.

Perguntas