DispatchConnect.StripeTapToPay.iOS 0.1.1

Dispatch Connect - Stripe Tap to Pay for iOS

Native iOS XCFramework wrapper for Stripe Terminal Tap to Pay functionality, designed for .NET MAUI iOS applications.

What's Included

This package contains two XCFrameworks:

• DCStripeTapToPayWrapper.xcframework - Custom Objective-C wrapper exposing Stripe Terminal functionality
• StripeTerminal.xcframework - Stripe Terminal SDK v5.x (dependency)

Requirements

• iOS 15.4 or later
• .NET 8.0 or later
• Xcode 15.0+ (for building)

Installation

Option 1: NuGet Package (Recommended)

dotnet add package DispatchConnect.StripeTapToPay.iOS

The frameworks will be automatically included in your iOS project via MSBuild.

Option 2: Manual Installation

1. Download TapToPayFrameworks.zip from GitHub Releases
2. Extract both XCFrameworks to your project
3. Add them as NativeReference items in your .csproj:

<ItemGroup Condition="'$(TargetPlatformIdentifier)' == 'ios'">
  <NativeReference Include="Native\DCStripeTapToPayWrapper.xcframework">
    <Kind>Framework</Kind>
    <SmartLink>True</SmartLink>
  </NativeReference>
  <NativeReference Include="Native\StripeTerminal.xcframework">
    <Kind>Framework</Kind>
    <SmartLink>True</SmartLink>
  </NativeReference>
</ItemGroup>

Usage

1. Initialize the SDK

// In your iOS-specific code or MauiProgram.cs
DCTapToPay.Shared.Initialize((completion) => 
{
    // Fetch connection token from your backend
    var token = await YourBackend.GetConnectionToken();
    completion(token, null);
});

2. Connect to Tap to Pay Reader

DCTapToPay.Shared.EnsureConnected("your_location_id", (error) => 
{
    if (error != null) 
    {
        Console.WriteLine($"Connection error: {error.LocalizedDescription}");
        return;
    }
    Console.WriteLine("Connected to Tap to Pay reader");
});

3. Process a Payment

var clientSecret = await YourBackend.CreatePaymentIntent(amount);

DCTapToPay.Shared.CollectAndProcess(clientSecret, (paymentIntentId, status, error) => 
{
    if (error != null) 
    {
        Console.WriteLine($"Payment error: {error.LocalizedDescription}");
        return;
    }
    Console.WriteLine($"Payment {status}: {paymentIntentId}");
});

4. Cancel Operation (Optional)

DCTapToPay.Shared.Cancel();

Info.plist Requirements

Add these keys to your iOS Info.plist:

<key>NSLocationWhenInUseUsageDescription</key>
<string>Location access is required to accept payments</string>

<key>NSBluetoothAlwaysUsageDescription</key>
<string>Bluetooth is used to connect to card readers</string>

<key>UIBackgroundModes</key>
<array>
    <string>bluetooth-central</string>
</array>

API Reference

DCTapToPay.Shared

• Initialize(fetchToken) - Initialize the Stripe Terminal SDK (call once at app startup)
• EnsureConnected(locationId, completion) - Discover and connect to Tap to Pay reader
• CollectAndProcess(clientSecret, completion) - Process a payment with the given PaymentIntent
• Cancel() - Cancel any ongoing operation

Error Codes

Support

• GitHub: https://github.com/Dispatch-Connect-Services/DCStripeTapToPayWrapper
• Issues: https://github.com/Dispatch-Connect-Services/DCStripeTapToPayWrapper/issues

License

MIT License - See LICENSE file for details