Tap to Pay op iPhone of Android en Stripe Terminal

Met Tap to Pay kunnen je gebruikers fysieke, contactloze betalingen ontvangen met een compatibel consumentenapparaat en de Stripe Terminal-SDK. Hiervoor moet je vertrouwd zijn met de Terminal-SDK en kennis van Android of iOS hebben. Bekijk onze technische integratiedocumentatie voor iOS hier en onze technische integratiedocumentatie voor Android hier.

Waar is Tap to Pay beschikbaar?

Je kunt hier en in onze technische documenten (zie de links hierboven) zien in welke landen Tap to Pay beschikbaar is.

Als je Tap to Pay in jouw land wilt gebruiken, maar dat nog niet mogelijk is, laat het ons dan weten. We brengen je dan op de hoogte wanneer Tap to Pay op jouw locatie beschikbaar is.

Aan welke vereisten moeten apparaten voldoen voor integratie met Tap to Pay?

Je kunt hier zien aan welke vereisten apparaten moeten voldoen voor Tap to Pay op iPhone.

Opmerking: iPads hebben geen NFC-leesfunctionaliteit en worden momenteel dus niet ondersteund.

Je kunt hier zien aan welke vereisten apparaten moeten voldoen voor Tap to Pay op Android.

Hier vind je een lijst van ondersteunde Android-apparaten met aangepaste interfaces.

Welke betaalmethoden worden ondersteund met Tap to Pay?

Je kunt hier documentatie vinden over de beschikbare betaalmethoden per kaartlezer.

Wat kost het?

Ga naar onze tariefpagina voor actuele tarieven.

Worden Tap to Pay-transacties verwerkt als transacties met een fysieke kaart?

Ja. Tap to Pay-transacties worden op het dashboard net als alle andere Terminal-transacties weergegeven als betalingen met 'Betaalkaart aanwezig'. Net zoals bij Stripe Terminal, zijn verkopers die Tap to Pay gebruiken om betaalkaarten te accepteren niet aansprakelijk voor frauduleuze chargebacks die worden ingediend voor zulke transacties.

Stripe Terminal, Tap to Pay en PCI-compliance

Stripe Terminal, inclusief Tap to Pay, is standaard inclusief E2EE. Gebruikers die Tap to Pay gebruiken, hebben op het dashboard onder Compliance-instellingen direct toegang tot een vooraf ingevuld SAQ C-document.

Opmerking: Tap to Pay kan niet worden gebruikt met P2PE.

Is er een manier om Tap to Pay-transacties te herkennen op het dashboard? Biedt Tap to Pay dezelfde functies als andere apparaten van Stripe Terminal?

Tap to Pay-transacties worden op het dashboard net als alle andere Terminal-transacties weergegeven als betalingen met 'Betaalkaart aanwezig'. Op het dashboard kunnen Tap to Pay-transacties momenteel niet worden onderscheiden van andere fysieke betalingen. Gebruikers hebben toegang tot dezelfde dashboardfuncties, zoals rapportage en terugbetalingen, met uitzondering van hardwareapparaten. Tap to Pay-apparaten kunnen momenteel niet worden gevolgd op het dashboard voor hardwarebeheer.

Is er een manier om het aantal actieve apparaten in een Stripe-account te reconciliëren met facturatie via Tap to Pay op iPhone?

Nee, dit is momenteel niet mogelijk.

Kan via Tap to Pay met een pincode worden betaald als transacties de limieten voor contactloos betalen overschrijden?

Tap to Pay op iPhone ondersteunt het invoeren van pincodes in de versies 2.23 en hoger van de Terminal-SDK voor iOS.

Tap to Pay op Android ondersteunt momenteel geen pincodes. Als een gebruiker probeert een bedrag te innen dat hoger is dan de limiet voor contactloze betalingen, kan de kaarthouder niet de reservepincode van de betaalrekening invoeren om de transactie te voltooien.

Maar gebruikers kunnen andere reserveopties overwegen. Zo kan er standaard een traditionele betaalterminal beschikbaar worden gesteld op locatie of een QR-code worden gegenereerd die de klant vervolgens kan scannen om af te rekenen met een CNP-transactie.

Regionale limieten voor contactloze betalingen worden vermeld op de ondersteuningspagina met veelgestelde vragen. Opmerking: Er zijn in het algemeen geen transactielimieten voor digitale wallets zoals Apple Pay en Google Pay.

Kun je betalingen innen met een fysieke Terminal-kaartlezer als reserveoptie?

Niet alle klanten hebben een contactloze betaalmethode. Als dit het geval is of een betaling wordt geweigerd, kunnen gebruikers een betaling innen door over te schakelen van Tap to Pay naar een Terminal-kaartlezer. Gebruikers kunnen echter slechts één actieve verbinding met een kaartlezer hebben. Je moet de kaartlezer dus eerst ontkoppelen als deze al is verbonden.

Werkt Tap to Pay op tablets?

Tap to Pay vereist NFC-technologie, waar veel tablets niet mee zijn uitgerust.

Tap to Pay op iPhone werkt niet op iPads, omdat deze momenteel geen NFC ondersteunen.

Tap to Pay op Android werkt op Android-tablets die voldoen aan onze apparaatvereisten.

Is er een manier om de naam van de kaarthouder te bekijken voor Tap to Pay-transacties?

De naam van de kaarthouder is meestal niet beschikbaar voor contactloze betalingen. In de API-documentatie lees je welke transactiespecifieke gegevens beschikbaar zijn voor Terminal-transacties, waaronder Tap to Pay.


Vragen over integraties

Moet een gebruiker een integratie met de Terminal-SDK hebben?

Ja, gebruikers moeten de Terminal-SDK-integratie hebben voltooid voor integratie met Tap to Pay. Raadpleeg de iOS- of Android-documentatie voor meer informatie.

Moet je als je een Terminal-integratie bouwt de Terminal-SDK installeren voordat je de Tap to Pay-SDK('s) installeert?

Ja. Om de Tap to Pay-functionaliteit te kunnen gebruiken, moeten gebruikers twee SDK-sets installeren. Eerst moet de Terminal-SDK-integratie worden voltooid en vervolgens de integratie met de Tap to Pay-SDK('s). Raadpleeg de iOS- of Android-documentatie voor meer informatie.

Heeft Terminal een kant-en-klare mobiele POS-app voor gebruikers?

Je kunt fysieke Tap to Pay-betalingen ontvangen met behulp van de Stripe Dashboard-app.

Als een gebruiker een apparaat met Tap to Pay meeneemt naar een ander land dat niet wordt ondersteund (bijvoorbeeld van de Verenigde Staten naar Brazilië), wordt de functionaliteit dan automatisch geblokkeerd? Moeten er aanvullende, op locatie gebaseerde beperkingen worden ingesteld in de app?

We verzamelen tijdens Terminal-transacties gps-gegevens om de locatie te verifiëren. Tap to Pay werkt niet wanneer het apparaat over een grens wordt vervoerd. Ons systeem weigert de transactie automatisch als een nieuw land wordt gedetecteerd. Voor deze functionaliteit is geen aanvullend integratiewerk vereist.

Kan een gebruiker Tap to Pay-transacties simuleren in de Terminal-simulator?

Ja, momenteel kunnen gebruikers het proces voor het innen van betalingen simuleren in de iOS- en Android-simulators.

Is Tap to Pay compatibel met apps die zijn gebouwd in React Native?

Ja, Tap to Pay kan worden gebruikt in apps die zijn gebouwd in React Native.

Is de optie om kaartgegevens op te slaan om deze later online opnieuw te gebruiken beschikbaar voor Tap to Pay-transacties?

Ja. Tap to Pay ondersteunt de huidige Terminal-functionaliteit om kaartgegevens op te slaan om deze later online opnieuw te kunnen gebruiken. De functionaliteit Kaart opslaan is alleen beschikbaar voor fysieke kaarten, niet voor mobiele wallets.

Kun je met Tap to Pay fooien geven?

Met Tap to Pay kunnen geen fooien worden gegeven met de kaartlezer (zie hier de documentatie hierover). Het staat gebruikers echter vrij om een eigen scherm voor het geven van fooi vóór inning van de betaling te implementeren. Ze kunnen hiervoor ook het proces na autorisatie gebruiken (lees hier meer over dat proces) zodat fooi kan worden gegeven na inning van de betaling. Als fooi wordt gegeven na autorisatie, moet dit wel uiterlijk drie minuten na inning van de betaling gebeuren. Voor een soepele gebruikerservaring raden we dan ook aan de mogelijkheid om fooi te geven vóór het innen van de betaling aan te bieden.

Is de offline modus compatibel met Tap to Pay?

Nee, de offline modus is niet compatibel met Tap to Pay.

Is er een manier om kaarttypen op Tap to Pay-niveau te beperken?

Nee, het is momenteel niet mogelijk om op Tap to Pay-niveau bepaalde betaalkaarten te beperken.

Werken testkaarten van Stripe met Tap to Pay?

Ja. Lees hier de documentatie.

Wat betekent de foutmelding 'on_behalf_of'?

Als je de parameter ‘on_behalf_of' gebruikt in je PaymentIntent, zorg dan dat je de ID van het gekoppelde account opgeeft in de SCPLocalMobileConnectionConfiguration. Raadpleeg de iOS- of Android-documentatie voor uitgebreide informatie.

Kan ik de interface van het aanraakscherm aanpassen?

Nee, je kunt de interface voor Tap to Pay op dit moment niet aanpassen. Dit geldt zowel voor iOS als voor Android.

Moet de gebruiker de aanraakzones in de integratie aanpassen voor elk apparaattype?

Voor Tap to Pay op Android wordt de transactie-interface verzorgd door Stripe. De eerste keer dat de telefoon als kaartlezer wordt gekoppeld, krijgt de gebruiker het standaardscherm van Stripe te zien. Bij daaropvolgende transacties wordt de aanraakzone aangepast aan de locatie van de NFC-chip op elk apparaat (bijvoorbeeld rechtsboven, linksboven, in het midden). Als de aanraakzone niet bekend is, wordt het standaardscherm gebruikt. Er is geen integratiewerk vereist om de aanraakzones aan te passen.

Hoe ingewikkeld is de integratie met deze bibliotheek?

Zodra de gebruiker de standaardintegratie met de iOS- of Android-SDK('s) van Terminal heeft voltooid, is de integratie voor Tap to Pay op iOS of Android vrij eenvoudig en vanzelfsprekend. Gemiddeld doet een technicus er minder dan twee weken over.


Vragen over Tap to Pay op iPhone

Raadpleeg voor veelgestelde vragen over Tap to Pay op iPhone de veelgestelde vragen voor verkopers van Apple.

Hoe verloopt de eerste onboarding voor iPhone-apparaten?

Gebruikers krijgen de servicevoorwaarden voor Tap to Pay op iPhone van Apple te zien wanneer ze voor het eerst verbinding maken met de lokale kaartlezer. Om zich te registreren bij Apple, moeten verkopers een geldige Apple-ID van hun onderneming opgeven voordat ze de voorwaarden van Apple accepteren. Dit proces hoeft voor elk Stripe-account maar één keer te worden uitgevoerd. Bij alle latere verbindingen via hetzelfde Stripe-account is dit niet meer nodig, welk apparaat er ook wordt gebruikt.

Voor meer informatie over het koppelen van verkopers ga je naar het gedeelte Bedrijfsgegevens voor Tap to Pay op iPhone in de veelgestelde vragen over Tap to Pay op iPhone van Apple.

Voordat je een apparaat kunt gebruiken om betaalkaarten te lezen, moet je het eerst configureren. Deze configuratie moet worden uitgevoerd voor elk apparaat waarop Tap to Pay op iPhone voor het eerst wordt gebruikt. De eerste configuratie van een apparaat kan twee minuten duren. Alle daaropvolgende configuratie-updates duren doorgaans maar een paar seconden. Raadpleeg het gedeelte Apparaatconfiguratie afhandelen voor meer informatie.

Worden de stappen voor het accepteren van de servicevoorwaarden voor Tap to Pay op iPhone transparant afgehandeld door de Terminal-SDK?

De servicevoorwaarden voor Tap to Pay op iPhone worden automatisch weergegeven bij de eerste verbinding van een lokale kaartlezer voor een bepaald account. Dit wordt impliciet afgehandeld door de Terminal-SDK en er is geen extra programmeerwerk nodig om de stappen voor acceptatie van de servicevoorwaarden te starten.

Wanneer vinden de stappen voor het accepteren van de servicevoorwaarden voor Tap to Pay op iPhone plaats?

De servicevoorwaarden voor Tap to Pay op iPhone worden weergegeven bij de eerste connectLocalMobileReader voor een bepaald Connect-subaccount. Wanneer de servicevoorwaarden zijn geaccepteerd, worden deze voor dat account niet meer weergegeven.

In de documentatie van Apple wordt bepaald dat 'alleen een gebruiker met beheerdersmachtigingen de voorwaarden mag accepteren namens een verkoper'. Moet de verkoper nog iets doen om aan te geven dat een gebruiker bevoegd is om de voorwaarden te accepteren?

We bevelen verkopers tijdens het onboardingproces van gebruikers te begeleiden om ervoor te zorgen dat de bevoegde verkoper de voorwaarden accepteert.

Volgens de best practices wordt aanbevolen om de kaartlezer op de achtergrond aan te sluiten bij het opstarten van de app. Hoe kan ik voorkomen dat de algemene voorwaarden voor Tap to Pay op iPhone worden getoond wanneer gebruikers de app voor het eerst starten?

Verkopers kunnen de parameter tosAcceptancePermitted uitschakelen door deze in te stellen op NO in de connectionConfig wanneer connectLocalMobileReader op de achtergrond wordt aangeroepen. Als een gebruiker de algemene voorwaarden nog niet heeft geaccepteerd, zal deze verbinding mislukken met een uitzonderingsfout. We raden verkopers aan dat ze deze uitzonderingsfout afhandelen en de gebruiker naar een duidelijk afzonderlijk onboardingproces leiden waar connectLocalMobileReader wordt aangeroepen met de parameter ingeschakeld, en waar de geautoriseerde verkoper de algemene voorwaarden kan accepteren.

In hoeverre kunnen platforms het getoonde Apple TTP-scherm met de naam van de onderneming configureren? Wordt op dit scherm de exacte handelsnaam (DBA) van het gekoppelde account weergegeven?

Platforms kunnen de naam van hun onderneming hier configureren. We gebruiken standaard de naam van het gekoppelde account, maar je kunt dit wijzigen als je dat wilt. Zorg dat je de correcte naam van de onderneming opgeeft.

Ondersteunt Stripe implementaties waarbij een verkoper direct gebruikmaakt van de proximityReader-API van Apple?

Momenteel ondersteunen we direct gebruik van de proximityReader-API van Apple niet. Voor een juist gebruik van de proximityReader is een directe relatie met Apple nodig voor de uitgifte van verbindingstokens voor kaartlezers.

Zijn er opties om de interface van Tap to Pay op iPhone aan te passen?

Nee, de interface van Tap to Pay op iPhone wordt geactiveerd wanneer je POS-app gereed is om een betaling te innen. Dit kan niet worden aangepast.

Moet je een locatie instellen voor je mobiele apparaat als je Tap to Pay op iPhone gebruikt? Is dit een vereiste van Apple?

Voor alle Terminal-hardwarelezers moet een locatie worden ingesteld. Dit is een bestaande vereiste die ook geldt voor Tap to Pay op iPhone.

Hoe zorg ik dat mijn iOS-app wordt goedgekeurd door Apple?

Je Tap to Pay op iPhone-app moet het standaardevaluatieproces van Apple voor de App Store doorlopen. Houd bij het bouwen van je app rekening met de richtlijnen van Apple voor de menselijke interface van Tap to Pay.

Hoe vraag ik de vereiste toestemming om Tap to Pay op iPhone te gebruiken aan en hoe configureer ik deze?

Je kunt direct toestemming aanvragen op de developersite van Apple, die je hier vindt.


Vragen over Tap to Pay op Android

Hoe weet ik of mijn telefoon NFC ondersteunt?

Je kunt in de instellingen van je Android-telefoon nagaan of het apparaat NFC ondersteunt. Als je een NFC-optie ziet, wordt deze ondersteund. Schakel de optie in om Tap to Pay te gebruiken.

Wanneer wordt Discover ondersteund?

We weten nog niet wanneer Discover ondersteund wordt.

Hoe blijf ik op de hoogte van relevante SDK-wijzigingen?

Meld je aan bij terminal-announce@lists.stripe.com. We streven ernaar om toekomstige wijzigingen minstens drie maanden van tevoren aan te kondigen, maar als er een kritiek beveiligingslek in de SDK wordt ontdekt, kan een SDK-update urgenter zijn.

Daarnaast zijn er openbare wijzigingslogboeken voor Tap to Pay op Android.


Ondersteuning

Ik heb een vraag over mijn Apple ID-account, Apple Business Register-account en/of iPhone-hardware.

Voor hulp bij Apple-gerelateerde kwesties kunnen gebruikers de volgende informatiebronnen raadplegen: