Pular para o conteúdo
Criar conta
ou
Entrar
O logotipo da documentação da Stripe
/
Pergunte à IA
Criar conta
Login
Comece já
Pagamentos
Receita
Plataformas e marketplaces
Gestão de valores
Recursos para desenvolvedores
Visão geral
Sobre os pagamentos da Stripe
Atualize sua integração
Análise de pagamentos
Pagamentos online
Visão geralEncontre seu caso de usoPagamentos gerenciados
Usar Payment Links
Crie uma página de checkout
Criar uma integração avançada
Crie uma integração no aplicativo
Formas de pagamento
Adicionar formas de pagamento
Gerenciar formas de pagamento
Checkout mais rápido com o Link
Interfaces de pagamento
Payment Links
Checkout
Web Elements
Elements no aplicativo
Cenários de pagamento
Gerenciar várias moedas
Fluxos de pagamento personalizados
Aquisição flexível
Orquestração
Pagamentos presenciais
Terminal
    Visão geral
    Aceite pagamentos presenciais
    Projeto de integração
    Selecione a máquina
      Stripe Reader S700
      BBPOS WisePOS E
      Stripe Reader M2
      BBPOS WisePad 3
      Tap to Pay
      Verifone P400
      BBPOS Chipper 2X BT
    Projete uma integração
    Início rápido
    Exemplos de aplicativos
    Testes
    Configuração do Terminal
    Configure a integração
    Conectar a uma máquina
    Como aceitar um pagamento
    Receber pagamentos com cartão
    Formas de pagamento adicionais
    Aceitar pagamentos offline
    Pagamentos de pedidos por correio e por telefone
    Considerações regionais
    Durante o checkout
    Receber gorjetas
    Colete e salve dados de pagamento para uso futuro
    Autorizações flexíveis
    Após o checkout
    Reembolsar transações
    Fornecer recibos
    Personalize o Checkout
    Mostrar carrinho
    Coletar entradas na tela
    Coletar dados de tarja magnética
    Coletar dados de toque para instrumentos NFC
    Aplicativos em dispositivos
    Gerenciar máquinas
    Pedir, devolver ou substituir máquinas
    Registrar máquinas
    Gerenciar locais e zonas
    Configurar máquinas
    Monitorar máquinas
    Criptografia
    Referências
    Referências da API
    Máquinas móveis
    Máquinas de cartão inteligentes
    Guia de migração de SDK
    Lista de verificação da implantação
    Fichas técnicas de máquinas do Stripe Terminal
Muito mais que pagamentos
Abra sua empresa
Cripto
Financial Connections
Climate
Entenda as fraudes
Proteção contra fraudes do Radar
Gerenciar contestações
Verificar identidades
Página inicialPagamentosTerminalSelect your reader

Tap to Pay

Learn how to accept contactless payments on a compatible iPhone or Android device.

Looking for a no-code solution? Accept payments from the Stripe Dashboard mobile app.

Use Tap to Pay on iPhone to accept in-person contactless payments with a compatible iPhone.

Tap to Pay on iPhone includes support for Visa, Mastercard, American Express contactless cards, and NFC-based mobile wallets (Apple Pay, Google Pay, and Samsung Pay). PIN entry is supported. Additionally, Discover is supported in the US, Interac is supported in Canada, and eftpos is supported in Australia. Stripe includes Tap to Pay on iPhone in the Terminal iOS SDK and the Terminal React Native SDK, and enables payments directly in your iOS mobile app.

Observação

For platforms, use of Tap to Pay on iPhone is subject to the Apple Acceptance Platform User Terms and Conditions.

Availability

Alemanha
Austrália
Canadá
Estados Unidos
França
Irlanda
Itália
Nova Zelândia
Países Baixos
Portugal
Reino Unido
República Tcheca

Observação

Tap to Pay on iPhone isn’t available in Puerto Rico.

Availability in Public preview

Áustria
Bélgica
Dinamarca
Espanha
Finlândia
Luxemburgo
Polônia
Suécia
Suíça

Get started

Tap to Pay on iPhone requires the latest version of the Terminal iOS SDK, and introduces an SCPDiscoveryMethodTapToPay discovery option and a connectReader method. The minimum required SDK version is 2.23.0. To support Interac in Canada, the minimum required SDK version is 3.6.0.

You must first set up the Terminal iOS SDK. After you’re familiar with the iOS SDK, you can start supporting Tap to Pay on iPhone within your application.

Entitlements and build file

To use Tap to Pay on iPhone to accept payments, your application must request and configure the Tap to Pay on iPhone entitlement from your Apple Developer account. Review the instructions for requesting this entitlement.

After you add an entitlements file to your app build target, add the following:

Keycom.apple.developer.proximity-reader.payment.acceptance
Value typeboolean
Valuetrue or 1

Supported devices

Tap to Pay requires an iPhone XS or later running a one-year or later iOS version. Apple’s Business Register documentation lists supported iOS versions. Advise your users to update to the latest iOS version for the best performance.

Observação

Tap to Pay won’t work on beta releases of iOS.

Cardholder verification limits and fallback

Some contactless card transactions above certain amounts might require additional cardholder verification methods (CVM) such as PIN entry. Tap to Pay on iPhone supports PIN entry for devices running iOS 16.4 or later.

NFC wallet payments (Apple Pay, Google Pay, and Samsung Pay) usually don’t require a PIN. However, in the UK, Canada, and Finland, regional requirements and card issuer policies can affect contactless payments.

In the UK, depending on the issuer, Strong Customer Authentication might require some cards to be inserted into a device. In such cases, if the card isn’t inserted, the payment is declined before the PIN screen appears, with the reason offline_pin_required.

In Canada and Finland, many issued cards are offline PIN only, meaning that entering the PIN requires physical contact, such as insertion into a device, which isn’t supported with Tap to Pay.

In these scenarios, we recommend asking the customer to try a different card or collecting payment in a different way. For example, using a Terminal card reader or sending a Payment Link.

When collecting payment with your mobile device, hold the card to the reader until it reads the chip information. You might need to wait a few seconds after the initial vibration when the card makes contact. In the event of a decline, use another method to collect payment, such as a Terminal card reader. You can only have one active connection to a reader at a time.

To test PIN entry in markets where PIN is accepted, use physical test cards with amounts ending in .03. In markets where PIN isn’t accepted, a transaction ending in .03 returns an online_or_offline_pin_required error code after the card is tapped, instead of allowing the user to test PIN entry.

Best practices and promotion guidelines

Follow the Human Interface Guidelines for Tap to Pay on iPhone to ensure of an optimal user experience and successful review process with Apple.

Consider the following:

  • Connect to the reader in the background on app startup to reduce wait times when collecting a payment.
  • Use automatic reconnection to reconnect to the reader when the app comes to the foreground to reduce wait times.
  • Provide merchant education to guide your users on how to accept contactless payments on a compatible iPhone, including in-product promotion and text or email alerts. See Apple’s developer marketing guidance. With iOS 18, you can use Apple’s ProximityReaderDiscovery API to provide merchant education for Tap to Pay on iPhone with a few lines of code. Apple ensures that the content is up to date and localized for your merchant’s region.
  • Launch and promote your Tap to Pay on iPhone marketing campaigns using our messaging templates and design assets following Apple’s brand guidelines. Become a Stripe Partner here to access these assets in the partner portal.

Next steps

  • Set up your integration
Esta página foi útil?
SimNão
  • Precisa de ajuda? Fale com o suporte.
  • Participe do nosso programa de acesso antecipado.
  • Confira nosso changelog.
  • Dúvidas? Fale com a equipe de vendas.
  • LLM? Read llms.txt.
  • Powered by Markdoc