Accept NFC tap-to-pay payments in your iOS app via MONEI Pay.
No special entitlements, certificates, or Apple approval needed — your app opens MONEI Pay, which handles the NFC payment, then calls back with the result.
- iOS 15.0+
- MONEI Pay installed on device
- POS auth token from your backend (
POST /v1/pos/auth-token)
Add to your Package.swift:
dependencies: [
.package(url: "https://github.com/MONEI/monei-pay-ios-sdk.git", from: "0.2.0")
]Or in Xcode: File → Add Package Dependencies → paste https://github.com/MONEI/monei-pay-ios-sdk.git
In your app's Info.plist, register a custom URL scheme (e.g. your bundle ID):
<key>CFBundleURLTypes</key>
<array>
<dict>
<key>CFBundleURLSchemes</key>
<array>
<string>my-merchant-app</string>
</array>
</dict>
</array><key>LSApplicationQueriesSchemes</key>
<array>
<string>monei-pay</string>
</array>SwiftUI:
@main
struct MyApp: App {
var body: some Scene {
WindowGroup {
ContentView()
.onOpenURL { url in
MoneiPay.handleCallback(url: url)
}
}
}
}UIKit:
func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey: Any] = [:]) -> Bool {
return MoneiPay.handleCallback(url: url)
}import MoneiPaySDK
do {
let result = try await MoneiPay.acceptPayment(
token: "eyJ...", // Raw JWT from your backend (no "Bearer " prefix)
amount: 1500, // Amount in cents (1500 = 15.00 EUR)
description: "Order #123", // Optional
customerName: "John Doe", // Optional
customerEmail: "[email protected]", // Optional
customerPhone: "+34600000000",// Optional
callbackScheme: "my-merchant-app" // Your registered URL scheme
)
print("Payment approved: \(result.transactionId)")
print("Card: \(result.cardBrand ?? "") \(result.maskedCardNumber ?? "")")
} catch MoneiPayError.moneiPayNotInstalled {
// Prompt user to install MONEI Pay
} catch MoneiPayError.paymentCancelled {
// User cancelled
} catch MoneiPayError.paymentTimeout {
// MONEI Pay didn't respond in time
} catch {
print("Payment failed: \(error.localizedDescription)")
}Accepts an NFC payment via MONEI Pay.
| Parameter | Type | Required | Description |
|---|---|---|---|
token |
String |
Yes | Raw JWT auth token (no "Bearer " prefix) |
amount |
Int |
Yes | Amount in cents |
description |
String? |
No | Payment description |
customerName |
String? |
No | Customer name |
customerEmail |
String? |
No | Customer email |
customerPhone |
String? |
No | Customer phone |
callbackScheme |
String |
Yes | Your app's registered URL scheme |
timeout |
TimeInterval? |
No | Timeout in seconds (default: 60) |
Returns PaymentResult. Throws MoneiPayError.
Handle incoming callback URL from MONEI Pay. Returns true if the URL was handled.
| Property | Type | Description |
|---|---|---|
transactionId |
String |
Unique transaction ID |
success |
Bool |
Whether payment was approved |
amount |
Int? |
Amount in cents |
cardBrand |
String? |
Card brand (visa, mastercard, etc.) |
maskedCardNumber |
String? |
Masked card number (****1234) |
| Case | Description |
|---|---|
.moneiPayNotInstalled |
MONEI Pay not on device |
.paymentInProgress |
Another payment is active |
.paymentTimeout |
Callback not received in time |
.paymentCancelled |
User cancelled |
.paymentFailed(reason:) |
Payment declined/failed |
.invalidParameters(_) |
Invalid input parameters |
.failedToOpen |
Could not open MONEI Pay |
The examples/MerchantDemo directory contains a minimal SwiftUI app demonstrating the full integration flow: enter an API key, fetch a POS auth token, and accept an NFC payment via MONEI Pay.
To run:
- Open
examples/MerchantDemo/MerchantDemo.xcodeprojin Xcode - Set your Apple Development Team in Signing & Capabilities
- Build and run on a device with MONEI Pay installed
The demo references the SDK as a local Swift package (../../), so any local SDK changes are picked up immediately.
Beta: MONEI Pay for iOS is currently in beta. Join via TestFlight.
Your backend generates POS auth tokens via the MONEI API:
curl -X POST https://api.monei.com/v1/pos/auth-token \
-H "Authorization: YOUR_API_KEY" \
-H "Content-Type: application/json"See the MONEI API docs for details.
MIT