Introduction to the Revolut Tap to Pay SDK for iOS

Welcome to the Revolut Tap to Pay SDK for iOS, a powerful tool that enables merchants to accept contactless payments directly on iPhone using Apple's Tap to Pay technology. Our main goal is to help merchants and payment orchestrators turn any supported iPhone into a payment acceptance device — no card reader hardware required.

This SDK allows you to leverage the following features and benefits:

1. No additional hardware: The SDK uses Apple's ProximityReader framework to accept contactless card and digital wallet payments directly on iPhone. No card readers, terminals, or Bluetooth pairing needed.
2. Automatic device pairing: The SDK handles Apple ProximityReader device pairing and Card Reader Token management internally — the integrator does not need to call pairing or token endpoints directly.
3. QR code payments: QR code is available as a primary payment option in performPayments (multi-payment mode), and as an automatic fallback in performPayment (single payment) when contactless isn't available.
4. Flexible payment modes: Accept a single payment for a fixed amount using performPayment, or accept a series of payments with an amount entry UI using performPayments.
5. Comprehensive payment lifecycle management: The SDK creates orders, processes payments, tracks transaction status, and returns the final result — including an optional receipt URL — to your app.
6. Secure token architecture: The SDK uses a TokenProviderProtocol that requests short-lived device tokens from your backend, ensuring long-lived OAuth credentials never touch the device.

By integrating the Revolut Tap to Pay SDK into your iOS apps, you provide merchants with a cutting-edge in-person payment experience that eliminates hardware costs while maintaining the security and reliability of Revolut's payment infrastructure.