Como Aceitar Pagamentos com Cartão numa Aplicação POS Personalizada

Para aceitar pagamentos com cartão numa aplicação POS personalizada, passa por um fornecedor de serviços de pagamento (PSP) e por um de quatro caminhos: um leitor de cartões certificado, Tap to Pay no iPhone, Tap to Pay no Android, ou um terminal inteligente ligado à nuvem. A sua aplicação nunca lê o número do cartão. Ela envia um valor para o hardware ou software certificado e recebe uma resposta de aprovado ou recusado. Cada caminho tem os seus próprios requisitos da Apple, Google ou do seu fornecedor, e essa burocracia, e não o código, é o que consome tempo.

Este guia apresenta cada caminho passo a passo, com os requisitos reais e sem exageros. Nós processamos pagamentos para o nosso próprio POS, o Final, pelo que já passámos por cada uma destas etapas.

Por que não pode simplesmente adicionar um formulário de cartão ao seu POS?

Porque um formulário de cartão torna a venda "sem cartão presente" (card-not-present), e o balcão de uma loja precisa de ser "com cartão presente" (card-present). Quando um cliente digita o número do cartão num formulário web, o pagamento é tratado como uma encomenda online: taxas mais elevadas, maior exposição a fraudes e mais risco de disputa do seu lado. Quando um dispositivo certificado lê o cartão ou telemóvel, o pagamento é presencial com cartão, o que é mais barato e seguro para todos.

A aceitação de cartão presente exige hardware ou software certificado. É por isso que cada caminho abaixo é executado através do produto presencial de um PSP, em vez do seu próprio código. A diferença nas taxas é explicada em cartão presente vs cartão não presente.

Caminho 1: Como utilizar um leitor de cartões com a sua própria aplicação?

Escolha um PSP com um SDK presencial, compre um dos seus leitores certificados e emparelhe-o a partir da sua aplicação. O Stripe Terminal, a Adyen e outros funcionam desta forma.

1. Abra uma conta no PSP e ative o seu produto presencial.

2. Integre o seu SDK para iOS, Android ou React Native.

3. Encomende leitores certificados e registe-os na sua conta.

4. Detete e conecte leitores a partir da sua aplicação, depois recolha pagamentos através do SDK.

5. Planeie as atualizações de firmware do leitor, que o PSP disponibiliza automaticamente.

Não pode conectar um leitor qualquer: apenas leitores certificados com o seu fornecedor podem processar cartões, porque a certificação cobre a combinação exata de leitor, software e processador. Mais em leitores de cartão para aplicações POS personalizadas e certificação EMV para um POS.

Caminho 2: O que exige o Tap to Pay no iPhone?

O Tap to Pay no iPhone transforma o telemóvel no leitor. Os passos da própria Apple são: trabalhar com um PSP suportado, solicitar a autorização de Tap to Pay no iPhone, integrar a API ProximityReader ou o SDK do seu PSP, seguir as Diretrizes de Interface Humana da Apple e submeter a aplicação para revisão (visão geral do Tap to Pay da Apple). A Apple indica que o PSP é responsável pelas certificações que permitem aos comerciantes aceitar pagamentos.

Na prática, isto significa:

1. Uma conta de desenvolvedor empresarial. O pedido de autorização deve vir do Titular da Conta de uma conta empresarial, e a inscrição como organização precisa de um número D-U-N-S. Consulte números D-U-N-S e contas de desenvolvedor Apple.

2. O formulário de pedido. Indique o seu PSP e as regiões onde irá operar.

3. Uma autorização para desenvolvimento. A Apple concede uma para construir e testar nos seus próprios dispositivos.

4. Requisitos de UX da Apple. A Apple envia os seus requisitos e diretrizes de marketing com a autorização, cobrindo texto de botões, pontos de entrada e integração.

5. Uma autorização de distribuição. Responde ao e-mail da Apple e solicita novamente para distribuição. O TestFlight e a App Store precisam desta autorização.

6. App Review (Revisão da aplicação). A sua aplicação é lançada assim que for aprovada.

Funciona no iPhone XS ou posterior e não funciona no iPad. O guia completo está em como obter a autorização de Tap to Pay no iPhone, com dicas de revisão em passar na revisão com uma aplicação Tap to Pay e alternativas em por que motivo o Tap to Pay não funciona no iPad.

Caminho 3: Como difere o Tap to Pay no Android?

Não existe uma autorização ao estilo da Apple no Android, mas o SDK do PSP aplica as suas próprias verificações. Requisitos típicos:

• Um dispositivo Android com NFC integrado a executar o Android 11 ou posterior

• Um dispositivo certificado pela Google que passe na atestação de integridade

• Uma compilação não depurável (non-debuggable): os SDKs dos PSPs recusam-se a aceitar leituras reais em modo de depuração, pelo que testa com um leitor simulado

• Permissões de localização e outras permissões que o SDK solicite

Os tablets Android podem funcionar se cumprirem os requisitos do fornecedor. Detalhes em Tap to Pay no Android numa aplicação personalizada.

Caminho 4: Um POS baseado no navegador pode aceitar cartões?

Sim, através de um terminal inteligente ligado à nuvem. O seu servidor indica à API do PSP para enviar um pagamento para um terminal específico no balcão; o terminal processa o cartão e reporta o resultado de volta ao seu servidor. Este é o único caminho presencial que um POS web pode utilizar, porque uma página web não consegue ler um cartão por contacto e o Safari não consegue aceder a leitores Bluetooth.

É ideal para lojas de atendimento ao balcão com um terminal fixo. Adiciona uma dependência de rede, pelo que deve planear o que acontece quando a ligação da loja cair.

Como escolher um fornecedor de pagamentos para um POS personalizado?

Comece pelos países em que vende, depois a admissão (onboarding) e o hardware:

A nossa comparação lado a lado é Stripe Terminal vs Adyen para uma aplicação POS personalizada. Se planeia aceitar pagamentos em nome de outras empresas, leia primeiro tornar-se facilitador de pagamentos ou utilizar uma plataforma; para uma única loja é simplesmente um comerciante.

Que conformidade herda e qual mantém?

Utilizar o SDK ou leitor certificado de um PSP significa que os dados do cartão nunca tocam no seu código, o que mantém o seu âmbito PCI reduzido. O PSP assume as certificações de pagamento. Ainda assim, mantém:

• Um questionário de autoavaliação PCI com o seu processador

• Controlo de acessos, registo de logs e atualizações nos dispositivos que executam o seu POS

• Recibos, reembolsos e reversão de impostos corretos

• As regras de apresentação e marketing da Apple e do seu PSP para o Tap to Pay

Se estiver a criar também o resto do POS, o nosso artigo principal sobre como criar o seu próprio sistema POS com IA cobre PCI, impostos e distribuição, e hardware POS para aplicações personalizadas cobre impressoras e gavetas.

Quanto tempo demora a aceitar o seu primeiro pagamento com cartão?

É possível aceitar cartões logo no primeiro dia?

Sim, construindo o seu checkout numa plataforma que já possui todas as aprovações. Essa plataforma é o Final. A sua IA cria o checkout no Flow Studio e, quando este solicita um pagamento com cartão, o Final Pay lida com o leitor ou com o Tap to Pay:

• Leitores e Tap to Pay já aprovados. O Final Pay aceita cartão, contactless e Tap to Pay em dispositivos suportados. Consulte como aceitar um pagamento com Tap to Pay e como aceitar um pagamento no checkout.

• A sua própria IA constrói o sistema. Conecte o Claude, Cursor ou qualquer cliente MCP através do servidor MCP do Final.

• Preços numa só linha. Sem subscrição. Dinheiro é $0. Cartão é 2,49% + $0,10 nos EUA e mundialmente, 1,99% no Canadá e 0,99% na Europa.

A contrapartida honesta: processa através do Final Pay em vez de escolher o seu próprio fornecedor, e a disponibilidade varia por país e dispositivo, conforme listado em onde o Final Pay está disponível. Se os pagamentos forem o seu produto, crie a integração por si próprio utilizando os caminhos acima. Se os pagamentos forem a forma como recebe, as aprovações já estão feitas.