Flutter SDK

dependencies:
  peachpayments_flutter: ^1.4.0
  peachpayments_flutter_netcetera_3ds: ^1.1.3   // optional
  peachpayments_flutter_scancard: ^1.1.3        // optional

flutter pub get

platform :ios, '15.1'

android {
    defaultConfig {
        minSdkVersion 21
    }
}

dart run peachpayments_flutter:apply_plugins

class MainActivity : FlutterFragmentActivity()

flutter run

import 'package:peachpayments_flutter/peachpayments_flutter.dart';

// Create an instance and initialise in main.dart or app startup
final _peach = PeachPayments();

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();

  _peach.init(HyperConfig(
    publishableKey: 'pk_test_your_publishable_key',
    customBackendUrl: 'https://app.sandbox-next.peachpayments.com/api',
  ));

  runApp(MyApp());
}

class AppConfig {
  static const bool isProduction = bool.fromEnvironment('dart.vm.product');

  static String get publishableKey =>
      isProduction ? 'pk_live_xxx' : 'pk_test_xxx';

  static String get apiBaseUrl =>
      isProduction ? 'https://app.next.peachpayments.com/api' : 'https://app.sandbox-next.peachpayments.com/api';
}

import 'package:flutter/material.dart';
import 'package:peachpayments_flutter/peachpayments_flutter.dart';

final _peach = PeachPayments();

class CheckoutScreen extends StatefulWidget {
  final int amount;
  final String currency;

  const CheckoutScreen({
    Key? key,
    required this.amount,
    required this.currency,
  }) : super(key: key);

  @override
  State<CheckoutScreen> createState() => _CheckoutScreenState();
}

class _CheckoutScreenState extends State<CheckoutScreen> {
  bool _isLoading = false;
  String? _error;

  Future<void> _startPayment() async {
    setState(() {
      _isLoading = true;
      _error = null;
    });

    try {
      // Step 1: Create Payment Intent on your server
      final checkoutData = await _createPaymentIntent();

      // Step 2: Initialise Payment Session
      await _peach.initPaymentSession(PaymentSheetParams(
        clientSecret: checkoutData.clientSecret,
        // Add other required parameters
      ));

      // Step 3: Present Payment Sheet
      final result = await _peach.presentPaymentSheet();

      // Step 4: Handle result
      _handlePaymentResult(result);
    } catch (e) {
      setState(() => _error = e.toString());
    } finally {
      setState(() => _isLoading = false);
    }
  }

  Future<CheckoutData> _createPaymentIntent() async {
    final response = await http.post(
      Uri.parse('${AppConfig.apiBaseUrl}/create-payment-intent'),
      headers: {'Content-Type': 'application/json'},
      body: jsonEncode({
        'amount': widget.amount,
        'currency': widget.currency,
      }),
    );

    final data = jsonDecode(response.body);
    return CheckoutData.fromJson(data);
  }

  void _handlePaymentResult(Map<String, dynamic>? result) {
    if (result != null && result['status'] == 'succeeded') {
      _showSuccess();
    } else if (result != null && result['status'] == 'failed') {
      setState(() => _error = result['message'] ?? 'Payment failed');
    }
    // null or cancelled - user dismissed
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text('Checkout')),
      body: Padding(
        padding: EdgeInsets.all(16),
        child: Column(
          children: [
            // Order summary
            Card(
              child: ListTile(
                title: Text('Total'),
                trailing: Text(
                  '${widget.currency} ${(widget.amount / 100).toStringAsFixed(2)}',
                  style: Theme.of(context).textTheme.headlineSmall,
                ),
              ),
            ),
            SizedBox(height: 24),

            // Error message
            if (_error != null)
              Container(
                padding: EdgeInsets.all(12),
                decoration: BoxDecoration(
                  color: Colors.red.shade50,
                  borderRadius: BorderRadius.circular(8),
                ),
                child: Text(_error!, style: TextStyle(color: Colors.red)),
              ),

            Spacer(),

            // Pay button
            SizedBox(
              width: double.infinity,
              height: 50,
              child: ElevatedButton(
                onPressed: _isLoading ? null : _startPayment,
                child: _isLoading
                    ? CircularProgressIndicator(color: Colors.white)
                    : Text('Pay Now'),
              ),
            ),
          ],
        ),
      ),
    );
  }
}

class CheckoutData {
  final String clientSecret;
  final String? customerId;
  final String? ephemeralKey;

  CheckoutData({
    required this.clientSecret,
    this.customerId,
    this.ephemeralKey,
  });

  factory CheckoutData.fromJson(Map<String, dynamic> json) {
    return CheckoutData(
      clientSecret: json['client_secret'],
      customerId: json['customer_id'],
      ephemeralKey: json['ephemeral_key'],
    );
  }
}

import 'package:peachpayments_flutter/peachpayments_flutter.dart';

final _peach = PeachPayments();

// Initialise payment session with configuration
await _peach.initPaymentSession(PaymentSheetParams(
  clientSecret: clientSecret,
  // Add other required parameters
));

// Present payment sheet
final result = await _peach.presentPaymentSheet();

PeachWalletButton(
  clientSecret: clientSecret,
  type: WalletButtonType.expressCheckout,   // or .googlePay / .applePay
  googlePay: const GooglePayButtonConfig(
    merchantName: 'Your Store',
    merchantCountryCode: 'ZA',
  ),
  onReady: (isReady) => setState(() => _walletReady = isReady),
  onResult: (result) {
    // result.status
  },
)

class MainActivity : FlutterFragmentActivity()

<key>CFBundleURLTypes</key>
<array>
  <dict>
    <key>CFBundleURLSchemes</key>
    <array><string>yourapp</string></array>
  </dict>
</array>

<intent-filter>
  <action android:name="android.intent.action.VIEW" />
  <category android:name="android.intent.category.DEFAULT" />
  <category android:name="android.intent.category.BROWSABLE" />
  <data android:scheme="yourapp" android:host="payment-return" />
</intent-filter>

import 'package:peachpayments_flutter/peachpayments_flutter.dart';

final _peach = PeachPayments();

await _peach.initPaymentSession(PaymentSheetParams(
  clientSecret: clientSecret,
  // Add other required parameters
));

Future<void> saveCardForLater(String customerId) async {
  // 1. Create Setup Intent on your server
  final setupData = await api.createSetupIntent(customerId);

  // 2. Initialise payment session with Setup Intent
  await _peach.initPaymentSession(PaymentSheetParams(
    clientSecret: setupData.clientSecret,
    // Add other required parameters
  ));

  // 3. Present sheet
  final result = await _peach.presentPaymentSheet();

  if (result != null && result['status'] == 'succeeded') {
    print('Card saved successfully!');
  }
}

import 'package:peachpayments_flutter/peachpayments_flutter.dart';

final _peach = PeachPayments();

Future<void> processPayment() async {
  try {
    // presentPaymentSheet returns Map<String, dynamic>?
    final result = await _peach.presentPaymentSheet();

    if (result == null) {
      // User dismissed - not an error
      return;
    }

    final status = result['status'];
    if (status == 'succeeded') {
      _onPaymentSuccess();
    } else if (status == 'failed') {
      _onPaymentFailed(result['message']);
    } else if (status == 'cancelled') {
      // User cancelled
    }
  } on PlatformException catch (e) {
    _handlePlatformError(e);
  } catch (e) {
    _handleGenericError(e);
  }
}

void _handlePaymentError(String? message) {
  final displayMessage = message ?? 'Payment failed.';
  _showErrorSnackBar(displayMessage);
}

void _showErrorSnackBar(String message) {
  ScaffoldMessenger.of(context).showSnackBar(
    SnackBar(
      content: Text(message),
      backgroundColor: Colors.red,
      action: SnackBarAction(
        label: 'Retry',
        textColor: Colors.white,
        onPressed: _startPayment,
      ),
    ),
  );
}

PaymentSheetAppearance _createAppearance() {
  return PaymentSheetAppearance(
    colors: PaymentSheetColors(
      primary: Color(0xFF0066FF),
      background: Colors.white,
      componentBackground: Color(0xFFF5F5F5),
      componentBorder: Color(0xFFE0E0E0),
      text: Colors.black,
      secondaryText: Colors.grey,
      placeholderText: Color(0xFF9E9E9E),
      icon: Colors.grey,
      error: Colors.red,
    ),
    shapes: PaymentSheetShapes(
      borderRadius: 12,
      borderWidth: 1,
    ),
    typography: PaymentSheetTypography(
      fontFamily: 'Roboto',
      sizeScaleFactor: 1.0,
    ),
    primaryButton: PaymentSheetPrimaryButton(
      colors: PrimaryButtonColors(
        background: Color(0xFF0066FF),
        text: Colors.white,
      ),
      shapes: PrimaryButtonShapes(
        borderRadius: 8,
      ),
    ),
  );
}

PaymentSheetAppearance getAppearance(BuildContext context) {
  final isDark = Theme.of(context).brightness == Brightness.dark;

  return PaymentSheetAppearance(
    colors: PaymentSheetColors(
      primary: Theme.of(context).primaryColor,
      background: isDark ? Color(0xFF1A1A1A) : Colors.white,
      text: isDark ? Colors.white : Colors.black,
    ),
  );
}

import 'package:flutter_test/flutter_test.dart';
import 'package:mockito/mockito.dart';

class MockPaymentApi extends Mock implements PaymentApi {}

void main() {
  group('CheckoutScreen', () {
    late MockPaymentApi mockApi;

    setUp(() {
      mockApi = MockPaymentApi();
    });

    testWidgets('shows pay button', (tester) async {
      await tester.pumpWidget(
        MaterialApp(
          home: CheckoutScreen(amount: 6500, currency: 'ZAR'),
        ),
      );

      expect(find.text('Pay Now'), findsOneWidget);
    });

    testWidgets('shows loading on pay tap', (tester) async {
      when(mockApi.createPaymentIntent(any))
          .thenAnswer((_) async => CheckoutData(clientSecret: 'pi_xxx'));

      await tester.pumpWidget(
        MaterialApp(
          home: CheckoutScreen(amount: 6500, currency: 'ZAR'),
        ),
      );

      await tester.tap(find.text('Pay Now'));
      await tester.pump();

      expect(find.byType(CircularProgressIndicator), findsOneWidget);
    });
  });
}

flutter clean && flutter pub get

flutter run

cd ios
pod deintegrate
pod install