# Zum Bezahlen Karte auflegen Erfahren Sie, wie Sie kontaktlose Zahlungen auf einem kompatiblen iPhone oder Android-Gerät akzeptieren. Suchen Sie nach einer No-Code-Lösung? [Akzeptieren Sie Zahlungen über die Stripe-Dashboard-Mobile-App](https://docs.stripe.com/no-code/in-person.md). # iPhone > This is a iPhone for when platform is ios. View the full page at https://docs.stripe.com/terminal/payments/setup-reader/tap-to-pay?platform=ios. Verwenden Tap to Pay auf dem iPhone, um kontaktlose persönliche Zahlungen mit einem [kompatiblen iPhone](https://docs.stripe.com/terminal/payments/setup-reader/tap-to-pay.md?platform=ios#supported-devices) zu akzeptieren. Tap to Pay auf dem iPhone bietet Unterstützung für kontaktlose Karten von Visa, Mastercard, American Express und Discover, NFC-basierte Mobile Wallets sowie [QR-basierte Zahlungsmethoden](https://docs.stripe.com/terminal/payments/additional-payment-methods.md). Die PIN-Eingabe wird unterstützt. Darüber hinaus wird [eftpos](https://docs.stripe.com/terminal/payments/regional.md?integration-country=AU#eftpos-payments) in Australien, [Interac](https://docs.stripe.com/terminal/payments/regional.md?integration-country=CA#interac-payments) in Kanada und [Cartes Bancaires](https://docs.stripe.com/terminal/payments/regional.md?integration-country=FR#cartes-bancaires-payments) in Frankreich unterstützt. Stripe umfasst Tap to Pay auf dem iPhone in der Terminal-iOS-SDK und im Terminal-React-Native-SDK und ermöglicht Zahlungen direkt in Ihrer mobilen iOS-App. > Für Plattformen unterliegt die Nutzung von Tap to Pay auf dem iPhone den [Nutzungsbedingungen der Apple Acceptance Platform](https://stripe.com/legal/apple-acceptance-platform). ### Verfügbarkeit - AT - AU - BE - CA - CH - CZ - DE - DK - ES - FR - GB - IE - IT - NL - NZ - PL - PT - SE - SG - US > Tap to Pay auf dem iPhone ist in Puerto Rico nicht verfügbar. ### Verfügbarkeit in (Public preview) - BG - CY - EE - FI - HR - HU - JP - LI - LT - LU - LV - MT - MY - NO - RO - SI - SK ## Jetzt starten #### iOS Tap to Pay auf dem iPhone führt eine [SCPDiscoveryMethodTapToPay](https://stripe.dev/stripe-terminal-ios/docs/Enums/SCPDiscoveryMethod.html#/c:@E@SCPDiscoveryMethod@SCPDiscoveryMethodTapToPay)-Erkennungsoption und eine [connectReader](https://stripe.dev/stripe-terminal-ios/docs/Classes/SCPTerminal.html#/c:objc\(cs\)SCPTerminal\(im\)connectReader:delegate:connectionConfig:completion:)-Methode ein. Integrieren Sie die neueste Version des [Terminal iOS SDK](https://docs.stripe.com/terminal/payments/setup-integration.md?terminal-sdk-platform=ios), um die neuesten Fehlerbehebungen und Funktionen aufzunehmen. Versionsspezifische Updates und Fehlerbehebungen können Sie im [SDK-Änderungsprotokoll](https://github.com/stripe/stripe-terminal-ios/blob/master/CHANGELOG.md) anzeigen. Die Anforderungen an Geräte und die Mindestversion des SDK können sich aufgrund aktualisierter Compliance-Anforderungen oder Sicherheitslücken ändern. Um sicherzustellen, dass Ihre Lösung den Tap-to-Pay-Anforderungen entspricht, abonnieren Sie[terminal-announce@lists.stripe.com](https://groups.google.com/a/lists.stripe.com/g/terminal-announce). So aktivieren Sie Tap to Pay in Ihrer iOS-Anwendung: 1. [Anfordern](https://developer.apple.com/documentation/proximityreader/setting-up-the-entitlement-for-tap-to-pay-on-iphone?language=objc) einer Berechtigung. 1. Das Terminal iOS SDK [einrichten](https://docs.stripe.com/terminal/payments/setup-integration.md?terminal-sdk-platform=iOS). 1. Mit dem Tap-to-Pay-Lesegerät [verbinden](https://docs.stripe.com/terminal/payments/connect-reader.md?terminal-sdk-platform=ios&reader-type=tap-to-pay). 1. Zahlung mit dem Tap-to-Pay-Lesegerät [einziehen](https://docs.stripe.com/terminal/payments/collect-card-payment.md?terminal-sdk-platform=ios). ### Berechtigungen und Builddatei Um Tap to Pay auf dem iPhone zu verwenden, um Zahlungen in Ihrer Anwendung zu akzeptieren, müssen Sie zunächst [die Entwicklungsberechtigung für Tap to Pay auf dem iPhone über Ihr Apple-Entwickler-Konto ](https://developer.apple.com/documentation/proximityreader/setting-up-the-entitlement-for-tap-to-pay-on-iphone?language=objc) anfragen und konfigurieren. Nachdem Sie die internen Tests abgeschlossen haben, müssen Sie eine Vertriebsberechtigung anfragen. Nachdem Sie die Entwicklungsberechtigungsdatei zu Ihrem App-Build-Target hinzugefügt haben, fügen Sie Folgendes hinzu: | | | | | Schlüssel | `com.apple.developer.proximity-reader.payment.acceptance` | | Wertetyp | `boolean` | | Wert | `true` oder `1` | Die Implementierung von Tap to Pay auf dem iPhone ist ein komplexer Prozess, bei dem Sie Ihre App bei Apple zur Genehmigung einreichen müssen. Für detaillierte Anweisungen können Sie unseren Leitfaden herunterladen: [Leitfaden für Tap to Pay (PDF)](https://docs.stripecdn.com/fd6123a72c0ea6d22019c125f9a35d855fe859b4e327faeb89a2934091830744.pdf) #### React Native Tap to Pay auf dem iPhone führt eine [tapToPay](https://stripe.dev/stripe-terminal-react-native/api-reference/modules/Reader.IOS.html#DiscoveryMethod)-Erkennungsoption und eine [ConnectReader](https://stripe.dev/stripe-terminal-react-native/api-reference/interfaces/StripeTerminalSdkType.html#connectreader-1)-Methode ein. Integrieren Sie die neueste Version des [Terminal React Native SDK](https://docs.stripe.com/terminal/payments/setup-integration.md?terminal-sdk-platform=react-native), um die neuesten Fehlerbehebungen und Funktionen einzubeziehen. Versionsspezifische Updates und Fehlerbehebungen können Sie im [SDK-Änderungsprotokoll](https://github.com/stripe/stripe-terminal-react-native/blob/master/CHANGELOG.md) anzeigen. Die Anforderungen an Geräte und die Mindestversion des SDK können sich aufgrund aktualisierter Compliance-Anforderungen oder Sicherheitslücken ändern. Um sicherzustellen, dass Ihre Lösung den Tap-to-Pay-Anforderungen entspricht, abonnieren Sie[terminal-announce@lists.stripe.com](https://groups.google.com/a/lists.stripe.com/g/terminal-announce). So aktivieren Sie Tap to Pay in Ihrer Anwendung: 1. [Anfordern](https://developer.apple.com/documentation/proximityreader/setting-up-the-entitlement-for-tap-to-pay-on-iphone?language=objc) einer Berechtigung. 1. Das Terminal iOS SDK [einrichten](https://docs.stripe.com/terminal/payments/setup-integration.md?terminal-sdk-platform=react-native). 1. Stellen Sie eine [Verbindung](https://docs.stripe.com/terminal/payments/connect-reader.md?terminal-sdk-platform=react-native&reader-type=tap-to-pay) mit dem Tap-to-Pay-Lesegerät her. 1. Zahlung mit dem Tap-to-Pay-Lesegerät [einziehen](https://docs.stripe.com/terminal/payments/collect-card-payment.md?terminal-sdk-platform=react-native). ### Berechtigungen und Builddatei Um Tap to Pay auf dem iPhone zu verwenden, um Zahlungen in Ihrer Anwendung zu akzeptieren, müssen Sie zunächst [die Entwicklungsberechtigung für Tap to Pay auf dem iPhone über Ihr Apple-Entwickler-Konto ](https://developer.apple.com/documentation/proximityreader/setting-up-the-entitlement-for-tap-to-pay-on-iphone?language=objc) anfragen und konfigurieren. Nachdem Sie die internen Tests abgeschlossen haben, müssen Sie eine Vertriebsberechtigung anfragen. Nachdem Sie die Entwicklungsberechtigungsdatei zu Ihrem App-Build-Target hinzugefügt haben, fügen Sie Folgendes hinzu: | | | | | Schlüssel | `com.apple.developer.proximity-reader.payment.acceptance` | | Wertetyp | `boolean` | | Wert | `true` oder `1` | Die Implementierung von Tap to Pay auf dem iPhone ist ein komplexer Prozess, bei dem Sie Ihre App bei Apple zur Genehmigung einreichen müssen. Für detaillierte Anweisungen können Sie unseren Leitfaden herunterladen: [Leitfaden für Tap to Pay (PDF)](https://docs.stripecdn.com/fd6123a72c0ea6d22019c125f9a35d855fe859b4e327faeb89a2934091830744.pdf) ## Unterstützte Geräte Für Tap to Pay ist mindestens ein iPhone XS mit einer iOS-Version von mindestens einem Jahr erforderlich. In der [Dokumentation zum Unternehmensregister von Apple](https://register-docs.apple.com/tap-to-pay-on-iphone/docs/sdk-and-api-guide#ios-versions-and-deprecation-management) sind die unterstützten iOS-Versionen aufgelistet. Empfehlen Sie Ihren Nutzerinnen und Nutzern, auf die neueste iOS-Version zu aktualisieren, um eine optimale Leistung zu erzielen. > Tap to Pay funktioniert nicht in Beta-Versionen von iOS. ## Limitierungen und Lösungen bei der Verifizierung des/der Karteninhabers/in Bei einigen kontaktlosen Kartentransaktionen, die einen [bestimmten Betrag](https://support.stripe.com/questions/what-are-the-regional-contactless-limits-for-stripe-terminal-transactions) überschreiten, sind zusätzliche Methoden zur Karteninhaberverifizierung (CVM) erforderlich, beispielsweise die Eingabe der PIN. „Tap to Pay“ auf dem iPhone unterstützt die PIN-Eingabe auf Geräten mit iOS 16.4 oder höher. Für NFC-Wallet-Zahlungen (Apple Pay, Google Pay und Samsung Pay) ist normalerweise keine PIN erforderlich. Im Vereinigten Königreich, in Kanada und Finnland können sich jedoch regionale Anforderungen und die Richtlinien für Kartenaussteller/innen auf kontaktlose Zahlungen auswirken. Im Vereinigten Königreich erfordert die starke Kundenauthentifizierung je nach Aussteller/in möglicherweise, dass einige Karten in ein Gerät eingesteckt werden. In solchen Fällen, wenn die Karte nicht eingeführt wird, wird die Zahlung abgelehnt, bevor der PIN-Bildschirm angezeigt wird, mit dem Grund `offline_pin_required`. In Kanada und Finnland können viele ausgestellte Karten nur mit Offline-PIN verwendet werden. Dies bedeutet, dass die Eingabe der PIN physischen Kontakt erfordert, z. B. das Einstecken in ein Gerät, was von Tap to Pay nicht unterstützt wird. In solchen Szenarien empfehlen wir, den Kunden/die Kundin zu bitten, eine andere Karte zu verwenden oder die Zahlung auf eine andere Weise einzuziehen. Zum Beispiel über ein Terminal-Kartenlesegerät oder indem ein [Zahlungslink](https://docs.stripe.com/payment-links.md) gesendet wird. Halten Sie beim Zahlungseinzug mit Ihrem Mobilgerät die Karte so lange an das Lesegerät, bis die Chip-Informationen gelesen werden. Möglicherweise müssen Sie nach der ersten Vibration einige Sekunden warten, wenn die Karte den Kontakt herstellt. Verwenden Sie im Falle einer Ablehnung eine andere Zahlungsmethode, z. B. ein Terminal-Kartenlesegerät. Es ist jeweils nur eine aktive Verbindung zu einem Lesegerät möglich. Um die PIN-Eingabe in Märkten zu testen, in denen die PIN akzeptiert wird, verwenden Sie [physische Testkarten](https://docs.stripe.com/terminal/references/testing.md#physical-test-cards) mit Beträgen, die auf 0,03 enden. In Märkten, in denen die PIN nicht akzeptiert wird, gibt eine Transaktion, die auf 0,03 endet, nach dem Auflegen der Karte einen `online_or_offline_pin_required`-Fehlercode zurück, anstatt dem/der Nutzer/in zu ermöglichen, die PIN-Eingabe zu testen. ## Schulung für Händler/innen > Apple verlangt, dass Sie bei der Aktivierung von „Tap to Pay“ auf dem iPhone eine Anleitung mit dem Titel „How to Tap“ einblenden. Sie müssen diese integrieren, bevor Sie Ihre App zur Prüfung einreichen. Verwenden Sie die [ProximityReaderDiscovery-API](https://developer.apple.com/documentation/proximityreader/proximityreaderdiscovery) von Apple, um dieses Overlay direkt in Ihrer App anzuzeigen. Es sind keine zusätzlichen Abhängigkeiten erforderlich, da `ProximityReader` ein integriertes iOS-System-Framework ist, das bereits vom Stripe Terminal SDK eingebunden wurde. Die API folgt einem zweistufigen Ablauf, der in der [Dokumentation von Apple](https://developer.apple.com/documentation/proximityreader/proximityreaderdiscovery) beschrieben wird: 1. Rufen Sie `content(for:)` auf, um die Schulungsinhalte abzurufen. 1. Rufen Sie `presentContent(_:from:)` auf, um diese anzuzeigen. ```swift func showHowToTap(from rootViewController: UIViewController) async throws { guard #available(iOS 18.0, *) else { // Provide your own fallback merchant education UI for earlier versions return } let discovery = ProximityReaderDiscovery() let content = try await discovery.content(for: .payment(.howToTap)) // Walk the presentedViewController chain to find the topmost view controller var topVC = rootViewController while let presented = topVC.presentedViewController { topVC = presented } discovery.presentContent(content, from: topVC) } ``` Beachten Sie bitte zwei Integrationsanforderungen: - Umschließen Sie den Aufruf mit einem `#available(iOS 18.0, *)`-Guard und stellen Sie eine Fallback-Nutzeroberfläche für frühere Versionen bereit. - Übergeben Sie den zum Zeitpunkt des Aufrufs obersten „presentedViewController“. Durchlaufen Sie die `presentedViewController`-Kette von Ihrem Root-ViewController aus, um diesen zu finden; andernfalls schlägt der Aufruf fehl. Apple stellt sicher, dass die Inhalte aktuell und an die Region Ihres Unternehmens angepasst sind. Weitere Strategien zur Händlerschulung, darunter Produktwerbung sowie Benachrichtigungen per SMS oder E-Mail, finden Sie in den [Marketing-Leitlinien für Entwickler/innen von Apple](https://developer.apple.com/tap-to-pay/marketing-guidelines/). ## Best Practices und Werberichtlinien Befolgen Sie die Richtlinien unter [Tap to Pay auf dem iPhone](https://developer.apple.com/design/human-interface-guidelines/technologies/tap-to-pay-on-iphone/), um eine optimale Nutzererfahrung und einen erfolgreichen Überprüfungsprozess durch Apple zu gewährleisten. Ziehen Sie Folgendes in Betracht: - Verbindung zum Lesegerät beim Start der App im Hintergrund, um die Wartezeiten beim Einzug einer Zahlung zu verkürzen. - Verwenden Sie die [automatische Wiederverbindung](https://docs.stripe.com/terminal/payments/connect-reader.md?terminal-sdk-platform=ios&reader-type=tap-to-pay#automatically-attempt-reconnection), um die Verbindung zum Lesegerät wiederherzustellen, wenn die App in den Vordergrund kommt, um Wartezeiten zu reduzieren. - Starten und bewerben Sie Ihre Marketingkampagnen für Tap to Pay auf dem iPhone mit unseren Messaging-Vorlagen und Design-Assets gemäß den [Apple-Markenrichtlinien](https://developer.apple.com/tap-to-pay/marketing-guidelines/#editorial-guidelines). Werden Sie [Stripe-Partner](https://stripe.com/partners/become-a-partner), um über das [Partnerportal](https://portal.stripe.partners/s) auf diese Assets zuzugreifen. # Android > This is a Android for when platform is android. View the full page at https://docs.stripe.com/terminal/payments/setup-reader/tap-to-pay?platform=android. Verwenden Sie Tap to Pay auf Android, um persönliche kontaktlose Zahlungen mit [kompatiblen NFC-fähigen Android-Geräten](https://docs.stripe.com/terminal/payments/setup-reader/tap-to-pay.md?platform=android#supported-devices) zu akzeptieren. Tap to Pay auf Android umfasst Support für kontaktlose Karten von Visa, Mastercard, American Express und Discover, NFC-basierte Mobile Wallets und [QR-basierte Zahlungsmethoden](https://docs.stripe.com/terminal/payments/additional-payment-methods.md). Die PIN-Eingabe wird unterstützt. Darüber hinaus wird [eftpos](https://docs.stripe.com/terminal/payments/regional.md?integration-country=AU#eftpos-payments) in Australien unterstützt, [Interac](https://docs.stripe.com/terminal/payments/regional.md?integration-country=CA#interac-payments) wird in Kanada unterstützt und [Cartes Bancaires](https://docs.stripe.com/terminal/payments/regional.md?integration-country=FR#cartes-bancaires-payments) wird in Frankreich unterstützt. Stripe integriert Tap to Pay auf Android in das Android-SDK und das Terminal-React-Native-SDK und ermöglicht Zahlungen direkt in Ihrer mobilen Android-App. ### Verfügbarkeit - AT - AU - BE - CH - DE - DK - FI - FR - GB - IE - IT - MY - NL - NZ - PL - SE - SG - US ### Verfügbarkeit in (Public preview) - BG - CA - CY - CZ - EE - ES - GI - HR - HU - LI - LT - LU - LV - MT - NO - PT - RO - SI - SK ## Jetzt starten #### Android Integrieren Sie die neueste Version des [Terminal Android SDK](https://docs.stripe.com/terminal/payments/setup-integration.md?terminal-sdk-platform=android), um die aktuellen Fehlerbehebungen und Funktionen zu erhalten. Versionsspezifische Updates und Fehlerbehebungen können Sie im [SDK-Änderungsprotokoll](https://github.com/stripe/stripe-terminal-android/blob/master/CHANGELOG.md) einsehen. Die Anforderungen an Geräte und die Mindestversion des SDK können sich aufgrund aktualisierter Compliance-Anforderungen oder Sicherheitslücken ändern. Um sicherzustellen, dass Ihre Lösung den Tap-to-Pay-Anforderungen entspricht, abonnieren Sie[terminal-announce@lists.stripe.com](https://groups.google.com/a/lists.stripe.com/g/terminal-announce). So aktivieren Sie Tap to Pay in Ihrer Android-Anwendung: 1. [Richten Sie](https://docs.stripe.com/terminal/payments/setup-integration.md?terminal-sdk-platform=android) das Terminal Android SDK ein. 1. Ersetzen Sie Ihre bestehenden `stripeterminal`-Abhängigkeiten durch die folgenden Abhängigkeiten: #### Kotlin ```kotlin dependencies { implementation("com.stripe:stripeterminal-taptopay:5.4.1") implementation("com.stripe:stripeterminal-core:5.4.1") // ... } ``` 1. [Stellen Sie eine Verbindung](https://docs.stripe.com/terminal/payments/connect-reader.md?terminal-sdk-platform=android&reader-type=tap-to-pay) mit dem Tap-to-Pay-Lesegerät her. 1. Zahlung mit dem Tap-to-Pay-Lesegerät [einziehen](https://docs.stripe.com/terminal/payments/collect-card-payment.md?terminal-sdk-platform=android). #### React Native Integrieren Sie die neueste Version des [Terminal React Native SDK](https://docs.stripe.com/terminal/payments/setup-integration.md?terminal-sdk-platform=react-native), um die neuesten Fehlerbehebungen und Funktionen einzuschließen. Die Anforderungen an das Gerät und die SDK-Mindestversion können sich aufgrund von aktualisierten Compliance-Anforderungen oder Sicherheitslücken ändern. Um sicherzustellen, dass Ihre Lösung den Tap to Pay-Anforderungen entspricht, abonnieren Sie [terminal-announce@lists.stripe.com](https://groups.google.com/a/lists.stripe.com/g/terminal-announce). So aktivieren Sie Tap to Pay in Ihrer Anwendung: 1. [Richten Sie](https://docs.stripe.com/terminal/payments/setup-integration.md?terminal-sdk-platform=react-native) das Terminal React Native SDK ein. 1. Stellen Sie eine [Verbindung](https://docs.stripe.com/terminal/payments/connect-reader.md?terminal-sdk-platform=react-native&reader-type=tap-to-pay) mit dem Tap-to-Pay-Lesegerät her. 1. Zahlung mit dem Tap-to-Pay-Lesegerät [einziehen](https://docs.stripe.com/terminal/payments/collect-card-payment.md?terminal-sdk-platform=react-native). ## Unterstützte Geräte Tap to Pay auf Android funktioniert mit einer Vielzahl von Android-Geräten, darunter Mobiltelefone, Kiosksysteme, Tablets und Handheld-Geräte. Sie können nur Geräte erkennen und eine Verbindung zu ihnen herstellen, die alle folgenden Kriterien erfüllen: - Verfügt über einen funktionierenden, integrierten NFC-Sensor und einen ARM-basierten Prozessor - Ist nicht gerootet und der Bootloader des Geräts ist gesperrt und unverändert - Führt Android 13 oder höher aus - Es wurde ein Sicherheitsupdate aus den letzten 12 Monaten installiert - Nutzt Google Mobil Services und hat die Google Play Store-App installiert - Hat einen Keystore mit Hardware-Support für ECDH ([`FEATURE_HARDWARE_KEYSTORE`](https://developer.android.com/reference/android/content/pm/PackageManager#FEATURE_HARDWARE_KEYSTORE) Version muss 100 oder höher sein) - Hat eine stabile Internetverbindung - Führt das vom Hersteller bereitgestellte, unveränderte Betriebssystem aus - Hat Entwickleroptionen deaktiviert Android-Geräteemulatoren werden von Tap to Pay nicht unterstützt. Die gleichen Geräteanforderungen werden im simulierten und im Produktions-Lesegerät durchgesetzt, um Entwicklern und Entwicklerinnen ein möglichst realistisches Testerlebnis zu bieten. ### Gerätetypen Zu den unterstützten Gerätetypen gehören unter anderem: | Gerätetyp | Hersteller | Modelle | | --------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- | ----------------------------- | | Countertop | [Sunmi](https://partner.posportal.com/stripe/stripe/catalog/category/view/id/11/) | D3 MINI, V3 MIX | | Handheld | Honeywell | CT32, CT37 | | iMin | Lark 1 | | [Sunmi](https://partner.posportal.com/stripe/stripe/catalog/category/view/id/11/) | L3, V3 | | Zebra | TC53E | | Kiosk | [Sunmi](https://partner.posportal.com/stripe/stripe/catalog/category/view/id/11/) | Flex 3 mit Qualcomm 6225-Chip | | Anmelden | iMin | Falcon 2 | | [Sunmi](https://partner.posportal.com/stripe/stripe/catalog/category/view/id/11/) | T3, T3 PRO | | Tablet | HMD Global | HMD T21 | | Samsung Galaxy | Registerkarte „Active5“ | | [Sunmi](https://partner.posportal.com/stripe/stripe/catalog/category/view/id/11/) | CPad | | Oukitel | RT3 Plus | | Ulefone | Armor Pad 4 Ultra | Einige Hersteller produzieren sowohl GMS- als auch Nicht-GMS-zertifizierte Geräte. Wenn Sie ein Gerät verwenden, das nicht von GMS zertifiziert ist, erhalten Sie beim Versuch, eine Verbindung herzustellen, die folgende Fehlermeldung `ATTESTATION_FAILURE: Device is not Google Mobile Services (GMS) certified`. Wenden Sie sich in diesem Fall an den Hersteller, um das Problem zu beheben. ### Mobiltelefone Unterstützte Mobiltelefone sind unter anderem: | Hersteller | Modelle | | -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Asus | ROG Phone 7-Serie, ROG Phone 8-Serie, ROG Phone 9, Zenfone 10, Zenfone 11 Ultra, Zenfone 12 Ultra, Zenfone 9 | | Google | Pixel 10, Pixel 10 Pro, Pixel 10 Pro Fold, Pixel 10 Pro XL, Pixel 6, Pixel 6 Pro, Pixel 6a, Pixel 7, Pixel 7 Pro, Pixel 7a, Pixel 8, Pixel 8 Pro, Pixel 8a, Pixel 9, Pixel 9 Pro, Pixel 9 Pro Fold, Pixel 9 Pro XL, Pixel 9a, Pixel Fold | | Honor | 100, 200, 200 Lite, 200 Pro, 200 Smart, 400, 400 Lite, 400 Pro, 400 Smart, 90, 90 Lite, 90 Smart, Magic V2, Magic V3, Magic V5, Magic Vs, Magic4 Pro, Magic5 Pro, Magic6, Magic6 Lite 5G, Magic6 Pro, Magic7 Lite, Magic7 Pro, Magic8 Lite, Magic8 pro, X5c Plus, X6, X6a, X6b, X6c, X7b, X7b 5G, X7c 5G, X7d, X8a, X8b, X9b 5G, X9c, X9c Smart, X9d | | Infinix | GT 20 Pro, GT 30, GT 30 Pro, HOT 40 Pro, HOT 40i, HOT 50 5G, HOT 50 Pro, HOT 50 Pro+, HOT 60 5G, HOT 60 Pro, HOT 60 Pro+, HOT 60i, NOTE 30, NOTE 30 Pro, NOTE 40, NOTE 40 5G, NOTE 40 Pro, NOTE 40 Pro 5G, NOTE 40 Pro+ 5G, NOTE 50, NOTE 50 Pro, NOTE 50 Pro+ 5G, NOTE 50S 5G, SMART 10 PLUS, ZERO 30, ZERO 40 | | Motorola | ThinkPhone 25 von Motorola, ThinkPhone von Motorola, edge (2022), edge 2023, edge 2024, edge 2025, edge 30 ultra, edge 40, edge 40 neo, edge 40 pro, edge 50, edge 50 fusion, edge 50 neo, edge 50 pro, edge 50 ultra, edge 60, edge 60 fusion, edge 60 neo, edge 60 pro, edge 60 stylus, edge 70, edge plus (2022), edge plus 2023, edge plus 5G UW (2022), moto g – 2025, moto g play - 2024, moto g power – 2025, moto g power 5G – 2024, moto g stylus 5G – 2023, moto g stylus 5G – 2024, moto g stylus 5G – 2025, moto g04, moto g04s, moto g05, moto g06, moto g06 power, moto g14, moto g15, moto g35 5G, moto g54 5G, moto g55 5G, moto g56 5G, moto g57 power, moto g64 5G, moto g64y 5G, moto g66j 5G, moto g67 power 5G, moto g72, moto g73 5G, moto g75 5G, moto g85 5G, moto g86 5G, moto g86 power 5G, moto g96 5G, razr 2022, razr 2023, razr 2024, razr 2025, razr 40, razr 40 ultra, razr 50, razr 50 ultra, razr 60, razr 60 ultra, razr plus 2023, razr plus 2024, razr plus 2025, razr ultra 2025 | | OnePlus | 10 Pro, 10 Pro 5G, 10R 5G, 10T 5G, 11 5G, 11R 5G, 12, 12R, 13, 13R, 13T, 13s, 15, Ace 5, Ace 6, Nord 3 5G, Nord 4, Nord 5, Nord CE4 Lite 5G, Nord CE5, Nord N30 SE 5G, Oneplus Ace 2 Pro, Open | | Oppo | A3, A3 Pro 5G/A3 5G/A80 5G, A38, A40/A3/A40m, A40/A40m, A5 5G, A5 Pro, A5 Pro 5G, A5/A5m, A58, A5x, A60, A60 5G, A78, A78 5G, A79 5G, A80 5G, F25 Pro 5G, Find N2 Flip, Find N3, Find N3 Flip, Find N5, Find X5 Pro, Find X6, Find X6 Pro, Find X7 Ultra, Find X8, Find X8 Pro, Find X9, Find X9 Pro, OPPO A38, OPPO A6 Pro 5G, OPPO A60 5G/ A3 5G, OPPO F31 5G, OPPO Reno8 Pro 5G, OPPO Reno8 T, Reno 11, Reno 11 Pro, Reno10 5G, Reno10 Pro+ 5G, Reno11 F 5G, Reno11 F 5G/Reno11 A, Reno12 5G, Reno12 F, Reno12 F 5G, Reno12 F/FS 5G, Reno12 Pro, Reno12 Pro 5G, Reno13 5G, Reno13 F 5G, Reno13 F 5G / Reno13 A, Reno13 Pro 5G, Reno14 5G, Reno14 F 5G, Reno14 F 5G/Reno14 FS 5G, Reno14 Pro 5G, realme C51 | | Redmi | 12 5G, 13C 5G, 15, 15 5G, 15C 5G, K50, K60 Pro, K60 Ultra, K70, Note 12, Note 12 Turbo, Note 13, Note 13 5G, Note 13 Pro, Note 13 Pro 5G, Note 13 Pro+ 5G, Note 14, Note 14 5G, Note 14 Pro, Note 14 Pro 5G, Note 14 Pro+, Note 14 Pro+ 5G, Turbo 3 | | Samsung Galaxy | A04s, A05s, A13, A14, A14 5G, A15, A15 5G, A16, A16 5G, A17, A17 5G, A23 5G, A24, A25 5G, A26 5G, A33 5G, A34 5G, A35 5G, A36 5G, A53 5G, A53 5G UW, A54 5G, A55 5G, A56 5G, F34 5G, F54 5G, Flip7 FE, M13, M14 5G, M15 5G, M33 5G, M34 5G, M35 5G, M36 5G, M53 5G, M56 5G, S22, S22 Ultra, S22+, S23, S23 FE, S23 Ultra, S23+, S24, S24 FE, S24 Ultra, S24+, S25, S25 Edge, S25 FE, S25 Ultra, S25+, Tab Active5, Tab Active5 5G, Tab Active5 Pro, Tab Active5 Pro 5G, Wide8, XCover7, XCover7 Pro, Z Flip4, Z Flip5, Z Flip6, Z Flip7, Z Fold4, Z Fold5, Z Fold6, Z Fold7 | | Xiaomi | 12, 12 Pro, 12T, 12T Pro, 13, 13 Lite, 13 Pro, 13 Ultra, 13T, 13T Pro, 14, 14 Pro, 14 Ultra, 14T, 14T Pro, 15, 15 Ultra, 17 Pro Max, MIX Fold 3, MIX Fold 4 | ## Nutzeroberfläche Tap to Pay auf Android enthält Bildschirme für den Zahlungseinzug. Wenn Ihre Anwendung bereit ist, eine Zahlung einzuziehen, übernimmt das Stripe Terminal-SDK die Anzeige, um den Zahlungsvorgang abzuwickeln. Nachdem Sie die [Zahlungsmethode zur Abwicklung](https://docs.stripe.com/terminal/payments/collect-card-payment.md#process-payment) aufgerufen haben, wird Ihre Anwendung weiterhin ausgeführt, während Tap to Pay eine Vollbildaufforderung anzeigt, die die Karteninhaber/innen anweist, ihre Karte oder NFC-basierte mobile Wallet anzutippen. Wenn beim Lesen der Karte ein Fehler auftritt, wird eine Aufforderung zum erneuten Versuch angezeigt. Ein erfolgreiches Antippen gibt eine Erfolgsanzeige zurück und dann kehrt die Kontrolle zu Ihrer Anwendung zurück. ### Gerätespezifische NFC-Tap-Zone Das Tap to Pay auf Android-SDK verschiebt die Anzeige des Tap-Bereichs automatisch, um der Endkundin/dem Endkunden zu verdeutlichen, wo sich der Bereich zum Antippen auf dem Gerät befindet: ![](https://d37ugbyn3rpeym.cloudfront.net/videos/terminal/ttpa-onscreen-demo-1.mp4)![](https://d37ugbyn3rpeym.cloudfront.net/videos/terminal/ttpa-onscreen-demo-2.mp4) Wenn das SDK die Position des Tap-Bereichs nicht automatisch ermitteln kann (z. B. wenn der Tap-Bereich offline ist), wird stattdessen eine Standardvariante verwendet: ![](https://d37ugbyn3rpeym.cloudfront.net/videos/terminal/ttpa-default-demo.mp4) ### Konfiguration der Nutzeroberfläche - [TapToPayUxConfiguration (Android)](https://stripe.dev/stripe-terminal-android/external/com.stripe.stripeterminal.external.models/-tap-to-pay-ux-configuration/index.html) - [TapToPayUxConfiguration (React Native)](https://stripe.dev/stripe-terminal-react-native/api-reference/types/TapToPayUxConfiguration.html) Sie können den Standard-Tap-Bildschirm mithilfe des Terminal SDK anpassen, einschließlich der Farben der Tap-Nutzeroberfläche, der Fehler- und Erfolgsmeldungen sowie der Position der Tap-Zone-Anzeige. Rufen Sie `setTapToPayUxConfiguration` während der Initialisierung oder beim Verbindungsaufbau mit dem Lesegerät auf. Sie können diese Funktion mehrmals aufrufen, um das Erscheinungsbild des Tap-Bildschirms während der Laufzeit Ihrer Anwendung anzupassen. Diese Konfiguration wirkt sich nur auf das Erscheinungsbild des Tap-Bildschirms aus, nicht auf den Bildschirm zur PIN-Eingabe. #### Android #### Kotlin ```kotlin val config = TapToPayUxConfiguration.Builder() .tapZone( TapToPayUxConfiguration.TapZone.Front(0.5f, 0.3f) ) .colors( TapToPayUxConfiguration.ColorScheme.Builder() .primary(TapToPayUxConfiguration.Color.Value(Color.parseColor("#FF008686"))) .success(TapToPayUxConfiguration.Color.Default) .error(TapToPayUxConfiguration.Color.Resource(android.R.color.holo_red_dark)) .build() ) .darkMode( TapToPayUxConfiguration.DarkMode.DARK ) .build() Terminal.getInstance().setTapToPayUxConfiguration(config) ``` #### React Native ```js import { useStripeTerminal, DarkMode, } from '@stripe/stripe-terminal-react-native'; const { setTapToPayUxConfiguration } = useStripeTerminal(); const callSetTapToPayUxConfiguration = async () => { let tapZone = { indicator: 'front', xBias: 0.5, yBias: 0.3, }; let darkMode = DarkMode.DARK; let colors = { primary: '#FF008686', error: '#FFCC0000', }; let config = { tapZone: tapZone, darkMode: darkMode, colors: colors, }; const { error } = await setTapToPayUxConfiguration(config); if (error) { console.log('setTapToPayUxConfiguration error', error); return; } console.log('setTapToPayUxConfiguration success'); }; ``` ![](https://d37ugbyn3rpeym.cloudfront.net/videos/terminal/ttpa-configuration-demo.mp4) ## Limitierungen und Lösungen bei der Verifizierung des/der Karteninhabers/in Bei einigen kontaktlosen Kartentransaktionen, die eine [bestimmten Betrag überschreiten](https://support.stripe.com/questions/what-are-the-regional-contactless-limits-for-stripe-terminal-transactions), sind zusätzliche Methoden zur Karteninhaberverifizierung (CVM) erforderlich, wie beispielsweise die PIN-Eingabe. Tap to Pay auf Android unterstützt die PIN-Eingabe ab Terminal Android SDK [4.3.0](https://github.com/stripe/stripe-terminal-android/releases/tag/v4.3.0). Die PIN wird in zwei Szenarien erfasst: - Der Transaktionsbetrag liegt über dem Limit der [Karteninhaber-Verifizierungsmethode (CVM)](https://support.stripe.com/questions/what-are-the-regional-contactless-limits-for-stripe-terminal-transactions). In diesem Fall wird die PIN erfasst, bevor [collectPaymentMethod](https://stripe.dev/stripe-terminal-android/core/com.stripe.stripeterminal/-terminal/collect-payment-method.html) zurückkehrt. Der Fokus liegt wieder auf Ihrer Anwendung, nachdem die PIN eingegeben oder die PIN-Erfassung abgebrochen wurde. ![Tap to Pay auf Android – lokaler PIN-Ablauf](https://b.stripecdn.com/docs-statics-srv/assets/ttpa-local-pin-flow.0f134662b73c0dfa4eaf1e57f09fd17a.png) - Der Aussteller erstellt eine Anfrage zur [starken Kundenauthentifizierung (SCA)](https://stripe.com/guides/strong-customer-authentication). In diesem Fall wird die PIN während [confirmPaymentIntent](https://stripe.dev/stripe-terminal-android/core/com.stripe.stripeterminal/-terminal/confirm-payment-intent.html) erfasst. Der Fokus kehrt nach `confirmPaymentIntent` zu Ihrer Anwendung zurück, es sei denn, der Aussteller stellt eine PIN-Anfrage. In diesem Fall liegt der Fokus wieder auf der PIN-Erfassung, bis die PIN eingegeben oder die PIN-Erfassung abgebrochen wird. ![Tap to Pay auf Android – SCA-PIN-Ablauf](https://b.stripecdn.com/docs-statics-srv/assets/ttpa-sca-pin-flow.4144d0670052a3544bfe573182bb9487.png) ### Umgang mit PIN-Fehlern Sie können eine PIN nur unter den folgenden Bedingungen erfassen: - [Entwickleroptionen](https://developer.android.com/studio/debug/dev-options) sind deaktiviert. - [Barrierefreiheitsdienste](https://developer.android.com/guide/topics/ui/accessibility/service) sind nicht registriert oder werden nicht ausgeführt. - Die [Bildschirmaufzeichnung](https://support.google.com/android/answer/9075928) ist nicht aktiv. - Es gibt keine [Bildschirmüberlagerungsfenster](https://developer.android.com/privacy-and-security/risks/tapjacking) - Sie verfügen über eine aktive Internetverbindung. Die PIN-Erfassung schlägt auch fehl, wenn eine Partei versucht, einen Screenshot zu erstellen. Wenn die PIN-Erfassung aufgrund eines dieser Faktoren fehlschlägt, erhalten Sie den Fehler `TAP_TO_PAY_INSECURE_ENVIRONMENT` mit zusätzlichen Informationen zur Fehlerursache. Wir empfehlen, dem/der Nutzer/in die Möglichkeit zu geben, die Zahlung erneut zu versuchen, um ihn/sie zur Eingabe einer PIN aufzufordern. ### Überlegungen zu regionalen PINs Für NFC-Wallet-Zahlungen (Apple Pay, Google Pay und Samsung Pay) ist normalerweise keine PIN erforderlich. Im Vereinigten Königreich, in Kanada und Finnland können sich jedoch regionale Anforderungen und die Richtlinien für Kartenaussteller/innen auf kontaktlose Zahlungen auswirken. Im Vereinigten Königreich erfordert die starke Kundenauthentifizierung je nach Aussteller/in möglicherweise, dass einige Karten in ein Gerät eingesteckt werden. In solchen Fällen, wenn die Karte nicht eingeführt wird, wird die Zahlung abgelehnt, bevor der PIN-Bildschirm angezeigt wird, mit dem Grund `offline_pin_required`. In Kanada und Finnland können viele ausgestellte Karten nur mit Offline-PIN verwendet werden. Dies bedeutet, dass die Eingabe der PIN physischen Kontakt erfordert, z. B. das Einstecken in ein Gerät, was von Tap to Pay nicht unterstützt wird. In solchen Szenarien empfehlen wir, den Kunden/die Kundin zu bitten, eine andere Karte zu verwenden oder die Zahlung auf eine andere Weise einzuziehen. Zum Beispiel über ein Terminal-Kartenlesegerät oder indem ein [Zahlungslink](https://docs.stripe.com/payment-links.md) gesendet wird. Halten Sie beim Zahlungseinzug mit Ihrem Mobilgerät die Karte so lange an das Lesegerät, bis die Chip-Informationen gelesen werden. Möglicherweise müssen Sie nach der ersten Vibration einige Sekunden warten, wenn die Karte den Kontakt herstellt. Verwenden Sie im Falle einer Ablehnung eine andere Zahlungsmethode, z. B. ein Terminal-Kartenlesegerät. Es ist jeweils nur eine aktive Verbindung zu einem Lesegerät möglich. ### PIN UX Aus Sicherheitsgründen wird das PIN-Pad nicht immer in der Mitte des Bildschirms angezeigt. Es erscheint an einer zufällig festgelegten Position. ![Tap to Pay auf Android – Bildschirm zur PIN-Erfassung](https://b.stripecdn.com/docs-statics-srv/assets/ttpa-pin-screen.ceb66e1d9695de8ca517e39265a2be10.png) Ein nicht in der Mitte angeordnetes Pin Pad ist ein zu erwartendes Verhalten. ## Best Practices und Werberichtlinien Sorgen Sie für ein optimales Nutzererlebnis, indem Sie Folgendes beachten: - Verbindung zum Lesegerät beim Start der App im Hintergrund, um die Wartezeiten beim Einzug einer Zahlung zu verkürzen. - Verwenden Sie die [automatische Wiederverbindung](https://docs.stripe.com/terminal/payments/connect-reader.md?terminal-sdk-platform=android&reader-type=tap-to-pay#automatically-attempt-reconnection), um die Verbindung zum Lesegerät wiederherzustellen, wenn die App in den Vordergrund kommt, um Wartezeiten zu reduzieren. - Stellen Sie Ihren Nutzern/Nutzerinnen Informationen zum Annehmen von kontaktlosen Zahlungen auf einem kompatiblen Android-Gerät zur Verfügung, indem sie Schulungen für Händler anbieten, einschließlich Werbung über Produkte und Text- oder E-Mail-Benachrichtigungen. - Starten und bewerben Sie Ihre Marketingkampagnen für Tap to Pay auf Android mit unseren Messaging-Vorlagen und Design-Assets. Werden Sie [Stripe-Partner](https://stripe.com/partners/become-a-partner), um über das [Partnerportal](https://portal.stripe.partners/s) auf diese Assets zuzugreifen. ## Nächste Schritte - [Integration einrichten](https://docs.stripe.com/terminal/payments/setup-integration.md) - [Mit einem Lesegerät verbinden](https://docs.stripe.com/terminal/payments/connect-reader.md) - [Kartenzahlung einziehen](https://docs.stripe.com/terminal/payments/collect-card-payment.md) - [Ihre Integration testen](https://docs.stripe.com/terminal/references/testing.md) - [Regionale Zahlungsmethoden](https://docs.stripe.com/terminal/payments/regional.md)