Manage payment devices

For the card reader solution, you need to add specific metadata to your POS app. You also need to present a device management UI for pairing your mobile device and the card reader, connecting to the card reader, and viewing card reader details.

Manage permissions

Your iOS POS app needs to have certain permissions for pairing the mobile device with the card reader.

• In the Info.plist of your POS app, add the following keys with an appropriate explanation:
  • NSBluetoothAlwaysUsageDescription : this enables setting up a Bluetooth pairing between the mobile device and the card reader.
  • NSCameraUsageDescription : this enables using the camera of the mobile device to scan the barcode of the card reader. Barcode scanning is one of the ways to select a card reader for pairing.

Suppress Apple Pay in your POS app

It is possible that Apple Pay is enabled on the Apple device that runs your iOS POS app. For example, if staff use their personal iPhone. When a card reader is near, the device running the POS app tries to make the payment using the Apple Pay passes that are on the device.

To prevent this from happening, you must suppress Apple Pay in your iOS POS app when your app is in the foreground.

1. Contact Apple Pay at apple-pay-inquiries@apple.com and ask for an entitlement to suppress Apple Pay.
2. When you receive confirmation that the entitlement was granted, add the entitlement to your provisioning profile on the Apple developer website.
3. In Xcode, in the Signing & Capabilities settings, add the com.apple.developer.passkit.pass-presentation-suppression key to the .entitlements file for your POS app.

4. In your POS app, call requestAutomaticPassPresentationSuppression.

   This method automatically switches between disabling Apple Pay when the POS app is in the foreground, and enabling Apple Pay when the POS app is in the background.

Use or create a UI for device management

To use the card reader, store staff needs to pair the mobile device running the Adyen POS Mobile SDK with the card reader. The SDK provides a built-in UI for that.
Store staff will also want to see an overview of card readers and view details of the card reader they are using. For example, to check the battery charge level. The SDK also provides a built-in UI for that. Here are some example screens.

To handle the device pairing and viewing of device details, you can:

• Use the built-in UI trough SwiftUI
• Use the built-in UI through UIKit
• Build a custom UI

Use the UI through SwiftUI

To use the device management screens built into the Adyen POS Mobile SDK from within SwiftUI:

• Add DeviceManagementView to the body property of your View. One of the ways to do that, is using a .sheet:

  struct MyView: View {
      @State private var showingDeviceManagement = false
      private let paymentService: PaymentService = ...
  
      var body: some View {
          { ... }
          .sheet(isPresented: $showingDeviceManagement) {
              NavigationView { DeviceManagementView(paymentService: paymentService) }
          }
      }
  }

Use the UI through UIKit

To use the device management screens built into the Adyen POS Mobile SDK from within UIKit:

1. Create an instance of DeviceManagementViewController using DeviceManagementViewController(paymentService:), passing your instance of PaymentService.

2. Present it in your preferred way. For example, with presentViewController:animated:completion::

   class MyViewController: UIViewController {
       let paymentService = PaymentService { ... }
   
       func presentDeviceManagement() {
           let deviceManagementViewController = DeviceManagementViewController(paymentService: paymentService)
           present(deviceManagementViewController, animated: true)
       }
   }

Custom UI

If you intend to build your own UI for device management:

• Use the DeviceManagerDelegate protocol to obtain all the necessary information. For details, refer to DeviceManagerDelegate in the Adyen POS Mobile SDK.

Next steps