Connect to a reader

Use the discoverReaders method to determine hardware support for Tap to Pay on your device.

If your application runs on a device that doesn’t meet the requirements above, the discoverReaders method returns an error.

export default function DiscoverReadersScreen() {
  const { discoverReaders, discoveredReaders } =
    useStripeTerminal({
      onUpdateDiscoveredReaders: (readers) => {
        // The `readers` variable will contain an array of all the discovered readers.
      },
    });

  useEffect(() => {
    const { error } = await discoverReaders({
      discoveryMethod: 'tapToPay',
    });
  }, [discoverReaders]);

  return <View />;
}

To accept Tap to Pay payments, provide the discovered reader from the previous step to the connectReader method.

You must register your reader to a location upon connection. To do so, you must pass the relevant location ID to connectReader.

When using destination charges with on_behalf_of on iPhones, you must also provide the connected account ID.

const { reader, error } = await connectReader({
    reader: selectedReader,
    locationId: 
'{{LOCATION_ID}}'
  },
  'tapToPay'
);

if (error) {
  console.log('connectTapToPayReader error:', error);
  return;
}

console.log('Reader connected successfully', reader);

Account linking and Apple terms and conditions

Users are presented with Apple’s Tap to Pay on iPhone Terms and Conditions the first time they connect to the reader on iPhones. To register with Apple, you must specify a valid Apple ID representing your business before accepting the terms presented by Apple. You only need to perform this once per Stripe account. This flow isn’t presented on subsequent connections using the same Stripe account, including on other mobile devices.

Each connected account must accept the Terms and Conditions when:

• A Connect user creates direct charges
• A Connect user creates a destination charge and specifies an on_behalf_of account

Link your Apple ID account to accept Tap to Pay payments

Learn more about account linking in the Tap to Pay on iPhone Business Information section of the Apple Tap to Pay on iPhone FAQ.