Tap to Pay no iPhone ou Tap to Pay no Android e o Stripe Terminal

O recurso Tap to Pay permite que os usuários aceitem pagamentos presenciais por aproximação com um dispositivo compatível e o SDK do Stripe Terminal. Ele exige familiaridade com o SDK do Terminal e conhecimento especializado sobre Android e iOS. Consulte nossa documentação de integração técnica do iOS aqui e a nossa documentação de integração técnica do Android aqui.

Onde o Tap to Pay está disponível?

Você encontra os países nos quais o Tap to Pay está disponível aqui ou no link acima da nossa documentação técnica.

Se o Tap to Pay ainda não estiver disponível no seu país e você quiser usar o serviço, fale conosco. Entraremos em contato assim que for possível atender à sua região.

Quais são os requisitos de dispositivo para integração do Tap to Pay?

Consulte os requisitos de dispositivo para o Tap to Pay no iPhone aqui.

Observação: os dispositivos iPad não têm recursos de leitura de NFC, então eles não são compatíveis no momento.

Consulte os requisitos de dispositivo para o Tap to Pay no Android aqui.

Veja uma lista de dispositivos Android aceitos com IUs personalizadas.

Quais formas de pagamento são aceitas com o Tap to Pay?

Consulte a documentação sobre as formas de pagamento disponíveis por máquina aqui.

Quais são os preços?

Acesse a nossa página de preços para ver os preços atuais.

As transações por Tap to Pay são encaminhadas como transações com cartão presente?

Sim. As transações por Tap to Pay podem ser identificadas no Dashboard como pagamentos do tipo "Cartão presente", como todas as outras transações do Terminal. Assim como o Stripe Terminal, os comerciantes que usam o Tap to Pay para aceitar cartões de pagamento não são responsáveis por nenhuma contestação por fraude registrada em tais transações.

Tap to Pay no Stripe Terminal e conformidade com PCI

Por padrão, o Stripe Terminal (incluindo o Tap to Pay) fornece E2EE. Os usuários que usam o Tap to Pay têm acesso a um documento SAQ C previamente preenchido, diretamente no seu Dashboard, em "Configurações de conformidade".

Observação: o Tap to Pay não é aceito para uso com P2PE.

Há uma maneira de identificar transações Tap to Pay no Dashboard? O Tap to Pay tem as mesmas funções que outros dispositivos do Stripe Terminal?

As transações por Tap to Pay podem ser identificadas no Dashboard como pagamentos do tipo "Cartão presente", como todas as outras transações do Terminal. Atualmente, não dispomos de uma função para identificar transações com Tap to Pay de outras cobranças de cartão presente no Dashboard. Os usuários continuarão tendo acesso às mesmas funções do Dashboard, como relatórios, reembolsos e outros, exceto dispositivos de hardware. Atualmente, os dispositivos habilitados para o uso do Tap to Pay não podem ser rastreados no Dashboard para fins de gerenciamento de frota.

Há alguma maneira de reconciliar o número de dispositivos ativos em uma conta Stripe com o faturamento do Tap to Pay no iPhone?

No momento, não oferecemos esta funcionalidade.

É possível usar o PIN com o Tap to Pay em transações que excedem os limites de pagamentos por aproximação?

O Tap to Pay no iPhone aceita o uso de PIN nas versões 2.23 e acima do SDK do Terminal para iOS.

No momento, o Tap to Pay no Android não aceita PIN. Se um usuário tentar cobrar um valor superior ao limite de pagamento por aproximação, o titular do cartão não conseguirá inserir o PIN de fallback da conta de pagamento para concluir a transação.

Como alternativa, os usuários podem explorar opções de backup, como ter um terminal de pagamento tradicional no local ou exibir um código QR e solicitar ao cliente que o escaneie e faça o checkout com uma transação sem cartão presencial.

Os limites regionais de pagamento por aproximação estão indicados na nossa página Perguntas e respostas sobre suporte. Observação: em geral, não há limites de transações para carteiras digitais como Apple Pay e Google Pay.

É possível receber pagamentos usando uma máquina de cartão física do Terminal como opção de backup?

Nem todos os clientes dispõem de uma forma de pagamento por aproximação. Nesse caso ou em caso de pagamento recusado, os usuários podem continuar recebendo pagamentos usando uma máquina de cartão do Terminal em vez do Tap to Pay. Entretanto, os usuários só podem ter uma conexão ativa com uma máquina por vez. Ou seja, será preciso desconectar a máquina de cartão se ela já estiver conectada.

O Tap to Pay funciona em tablets?

O Tap to Pay requer a tecnologia NFC, que muitos tablets não têm.

O Tap to Pay no iPhone não funciona em iPads porque eles ainda não são compatíveis com NFC.

O Tap to Pay no Android funciona em tablets Android que cumprem nossos requisitos de dispositivos.

Há alguma maneira de identificar o nome do titular do cartão para transações Tap to Pay?

O nome do titular do cartão normalmente não está disponível em pagamentos por aproximação. Acesse a referência da API para entender quais detalhes específicos da transação estão disponíveis para transações do Terminal, incluindo Tap to Pay.


Perguntas sobre a integração

O usuário precisa fazer integração com o SDK do Terminal?

Sim, primeiro os usuários devem concluir a integração com o SDK do Terminal antes de integrarem o Tap to Pay. Consulte a documentação para iOS ou Android para obter detalhes específicos.

Ao criar a integração com o Terminal, é preciso instalar o SDK do Terminal antes dos SDKs do Tap to Pay?

Sim. Para acessar as funções do recurso Tap to Pay, os usuários precisam instalar dois conjuntos de SDKs. Eles devem concluir a integração com o SDK do Terminal antes de integrar os SDKs do Tap to Pay. Confira a nossa documentação para iOS ou Android para obter detalhes específicos.

O Terminal tem algum aplicativo pré-integrado de POS para dispositivos móveis que os usuários possam utilizar?

Você pode aceitar pagamentos presenciais com Tap to Pay usando o aplicativo Stripe Dashboard.

Se um usuário levar um dispositivo Tap to Pay para outro país onde não é aceito (por exemplo, dos EUA para o Brasil), as funções serão bloqueadas automaticamente? É preciso configurar outras restrições no aplicativo com base na localização?

Coletamos dados de GPS para verificar a localização durante as transações no Terminal. O Tap to Pay não funcionará se for levado para outros países. Nosso sistema recusará automaticamente a transação se um novo país for detectado. Esse recurso não exige nenhum trabalho adicional de integração.

Um usuário pode simular transações com Tap to Pay no simulador do Terminal?

Atualmente, os usuários podem simular o fluxo de cobrança de pagamentos nos simuladores para iOS e Android.

O Tap to Pay é compatível com aplicativos criados no React Native?

Sim, o Tap to Pay é aceito em aplicativos criados no React Native.

A capacidade de salvar dados do cartão para reutilização online se aplica às transações feitas com Tap to Pay?

Sim. O Tap to Pay aceita a função existente do Terminal de salvar dados de cartão para reutilização online futura. A função "Salvar cartão" se aplica somente a cartões físicos, não a carteiras digitais.

É possível dar gorjetas em transações com Tap to Pay?

O pagamento de gorjetas na máquina (consulte nossa documentação aqui) não é compatível com o Tap to Pay. Os usuários podem implementar sua própria tela para receber gorjetas antes da cobrança ou, se preferirem, podem usar o fluxo de pós-autenticação para receber gorjetas (consulte esse fluxo aqui) após a cobrança do pagamento. Vale ressaltar que o recebimento de gorjetas pós-autenticação deve ser concluído em três minutos após a cobrança do pagamento. Para oferecer uma melhor experiência ao usuário, recomendamos apresentar o recebimento da gorjeta antes da cobrança do pagamento.

O modo offline é compatível com o Tap to Pay?

Não. O modo offline não é compatível com Tap to Pay.

Há alguma maneira de restringir tipos de cartão no Tap to Pay?

Não. Não oferecemos a função de restringir cartões no âmbito do Tap to Pay.

Os cartões de teste da Stripe funcionam com o Tap to Pay?

Sim. Consulte a nossa documentação aqui.

Estou vendo um erro on_behalf_of. O que isso significa?

Se você estiver usando o parâmetro on_behalf_of no seu PaymentIntent, não deixe de informar o ID da conta conectada em SCPLocalMobileConnectionConfiguration. Consulte a documentação para iOS ou Android para obter detalhes completos.

Posso personalizar a IU da tela de toque?

Não. No momento, não é possível personalizar a IU do Tap to Pay para iOS ou Android.

O usuário precisará personalizar as zonas de toque para cada tipo de dispositivo da integração?

No caso do Tap to Pay no Android, a Stripe se encarrega da IU da transação. Na primeira vez em que o telefone for conectado como a máquina, o usuário verá a tela "padrão" da Stripe. Depois disso, as transações subsequentes terão a solicitação da zona de toque personalizada de acordo com o local do chip NFC em cada dispositivo (por exemplo, no canto superior direito, no canto superior esquerdo, ao centro). Se a zona de toque não for conhecida, a tela padrão será utilizada. Não é necessário fazer nenhum trabalho de integração para personalizar as zonas de toque.

Qual é o nível de esforço previsto para fazer a integração dessa biblioteca?

Assim que o usuário conclui a integração padrão com os SDKs do Terminal para iOS ou Android, as respectivas integrações do Tap to Pay com cada sistema são relativamente simples e diretas. Em média, é preciso de menos de duas semanas para um engenheiro concluir a tarefa.


Perguntas relacionadas ao Tap to Pay no iPhone

Para ver perguntas frequentes relacionadas ao Tap to Pay no iPhone, consulte as Perguntas frequentes de comerciantes da Apple.

Como é feito o onboarding inicial para dispositivos iPhone?

Os usuários visualizarão os Termos e Condições do Tap to Pay no iPhone na primeira vez em que se conectarem à máquina local. Para se registrar na Apple, os comerciantes precisam especificar um ID Apple válido que representa a empresa antes de aceitar os termos apresentados pela Apple. Observe que esse fluxo só precisa ser realizado uma vez por conta Stripe. Esse fluxo será ignorado em todas as conexões subsequentes que usarem a mesma conta Stripe em todos os dispositivos.

Para saber mais sobre o vínculo de comerciantes, acesse a seção "Informações comerciais do Tap to Pay no iPhone" nas Perguntas frequentes do Tap to Pay no iPhone da Apple.

Antes de usar um dispositivo para ler cartões de pagamento, é preciso configurá-lo corretamente. Essa configuração precisa ser feita em cada dispositivo que usar o Tap to Pay no iPhone pela primeira vez. A configuração inicial de um dispositivo pode levar até dois minutos. As atualizações de configuração seguinte deverão levar apenas alguns segundos. Consulte a seção Gerenciar configuração de dispositivos para obter mais informações.

As etapas para aceitação dos Termos de Serviço do Tap to Pay no iPhone são gerenciadas com transparência pelo SDK do Terminal?

Os Termos de Serviço para Tap to Pay no iPhone são exibidos automaticamente na primeira conexão com a máquina local de uma determinada conta. Esse processo é gerenciado de modo implícito pelo SDK do Terminal, e nenhum código adicional é necessário para acionar o fluxo de Termos de Serviço.

Quando ocorrem as etapas dos Termos de Serviço do Tap to Pay no iPhone?

Os Termos de Serviço do Tap to Pay no iPhone são apresentados na primeira connectLocalMobileReader de uma determinada subconta conectada. Assim que forem aceitos, os Termos de Serviço não serão mais exibidos para a conta em questão.

A documentação da Apple menciona um requisito que diz que "Somente um usuário administrador pode aceitar os Termos e Condições em nome de um comerciante". O comerciante precisa fazer algo para indicar que um usuário está autorizado a aceitar os Termos e Condições?

Recomendamos que os comerciantes forneçam orientações durante o onboarding de usuários para assegurar que o comerciante autorizado esteja aceitando os termos.

As melhores práticas recomendam conectar-se à máquina em segundo plano ao iniciar o aplicativo. Como faço para evitar que os Termos e Condições do Tap to Pay no iPhone fiquem aparecendo quando os usuários executam o aplicativo pela primeira vez?

Os comerciantes definem o parâmetro tosAcceptancePermitted como NÃO no connectionConfig quando chamam connectLocalMobileReader em segundo plano. Se um usuário ainda não tiver aceitado os ToS, essa conexão apresentará falha com uma exceção. Recomendamos que os comerciantes gerenciem essa exceção e guiem o usuário para um fluxo de onboarding explícito e separado, no qual connectLocalMobileReader é chamado com o parâmetro ativado e o comerciante autorizado possa aceitar os ToS.

Quando a tela do TTP Apple aparece e mostra o nome da empresa, em que medida isso é configurável para as plataformas? Ele é específico para o nome fantasia exato da conta conectada?

As plataformas podem configurar o nome da empresa aqui. Nós usamos o nome da conta conectada como padrão, mas você pode substituí-lo se desejar. Certifique-se de especificar o nome da empresa corretamente.

A Stripe aceita implementações em que um comerciante usa a API proximityReader da Apple?

No momento, não aceitamos o uso direto da API proximityReader da Apple. O uso correto da proximityReader depende de um relacionamento direto com a Apple para emitir tokens de conexão da máquina.

Há opções disponíveis para personalizar a interface do usuário do Tap to Pay no iPhone?

Não. A IU do Tap to Pay no iPhone é acionada quando seu aplicativo de ponto de venda está pronto para cobrar um pagamento. Ela não pode ser personalizada.

É necessário definir uma localização para o dispositivo móvel ao usar o Tap to Pay no iPhone? Isso é exigido pela Apple?

Todas as máquinas de hardware do Terminal devem definir uma Localização. Esse é um requisito que também se aplica ao Tap to Pay no iPhone.

Como faço para que o meu aplicativo iOS seja aprovado pela Apple?

Seu aplicativo Tap to Pay no iPhone passará pelo processo de análise padrão da Apple App Store. Considere as Diretrizes sobre Interface Humana do Tap to Pay da Apple quando criar seu aplicativo.

Como faço para solicitar e configurar a habilitação exigida para aceitar o Tap to Pay no iPhone?

Você pode solicitar essa habilitação diretamente no site de desenvolvedores da Apple aqui.


Perguntas relacionadas ao Tap to Pay no Android

Como faço para saber se meu telefone aceita NFC?

Para verificar se o seu dispositivo Android aceita NFC, consulte as configurações do seu telefone. Se houver a opção NFC, o recurso é aceito. Basta verificar se ele está ativado para usar o Tap to Pay.

Quando a Discover será aceita?

No momento, não temos um cronograma para aceitar Discover.

Como faço para acompanhar as mudanças relevantes nos SDKs?

Assine terminal-announce@lists.stripe.com. Pretendemos avisar com pelo menos três meses de antecedência sobre qualquer alteração futura, mas atualizações mais urgentes podem ser necessárias se uma vulnerabilidade crítica de segurança for descoberta no SDK.

Além disso, o Tap to Pay no Android tem changelogs públicos.


Suporte

Tenho dúvidas sobre minha conta do ID Apple, conta do Apple Business Register (ABR) e/ou hardware do iPhone.

Os usuários podem obter suporte para problemas relacionados à Apple nos seguintes recursos: