All Fintech Flutter SDK 🚀

The most comprehensive Flutter SDK for Nigerian fintech APIs - Integrate payments, banking, and financial services with a single, unified interface.

🌟 Why Choose All Fintech SDK?

🎯 One SDK, Multiple Providers - Paystack, Flutterwave, Monnify, Opay, Open Banking
🔒 Enterprise Security - OAuth 2.0, signature verification, webhook handling
🎨 Beautiful UI Components - Material Design 3 payment sheets and forms
⚡ Production Ready - Offline support, error handling, circuit breaker patterns
📱 Type Safe - Complete Dart models with null safety
🔄 Dual Architecture - Data-only operations OR UI-enabled components

🚀 Quick Start

Installation

dependencies:
  all_fintech_flutter_sdk: ^1.0.0

Basic Setup

import 'package:all_fintech_flutter_sdk/all_fintech_flutter_sdk.dart';

// Initialize SDK
final sdk = AllFintechSDK.initialize(
  provider: FintechProvider.paystack,
  apiKey: 'your-api-key',
  publicKey: 'your-public-key', // Optional for some providers
  isLive: false, // Set to true for production
);

💳 Payment Examples

Paystack Integration

// Data-only payment
final transaction = await sdk.paystack.data.initializeTransaction(
  TransactionRequest(
    email: 'customer@example.com',
    amount: 50000, // Amount in kobo (₦500.00)
    reference: 'unique-reference-${DateTime.now().millisecondsSinceEpoch}',
  ),
);

// UI-enabled payment sheet
await sdk.paystack.ui.showPaymentSheet(
  context: context,
  email: 'customer@example.com',
  amount: 50000,
  onSuccess: (transaction) {
    print('Payment successful: ${transaction.reference}');
  },
  onError: (error) {
    print('Payment failed: $error');
  },
);

Flutterwave Integration

// Create customer
final customer = await sdk.flutterwave.data.createCustomer(
  FlutterwaveCustomerRequest(
    email: 'customer@example.com',
    name: 'John Doe',
    phoneNumber: '+2348123456789',
  ),
);

// Process payment
await sdk.flutterwave.ui.showPaymentSheet(
  context: context,
  amount: 25000,
  currency: 'NGN',
  customerEmail: 'customer@example.com',
  onSuccess: (charge) {
    print('Flutterwave payment successful: ${charge.id}');
  },
);

Monnify Integration

// Initialize Monnify (uses OAuth 2.0)
final monnifySDK = AllFintechSDK.initialize(
  provider: FintechProvider.monnify,
  apiKey: 'your-api-key',
  publicKey: 'your-secret-key',
  isLive: false,
);

// Create reserved account
final account = await monnifySDK.monnify.data.createReservedAccount(
  MonnifyReservedAccountRequest(
    accountReference: 'unique-ref-123',
    accountName: 'John Doe',
    currencyCode: 'NGN',
    contractCode: 'your-contract-code',
    customerEmail: 'john@example.com',
  ),
);

// Show payment sheet
await monnifySDK.monnify.ui.showPaymentSheet(
  context: context,
  amount: 100000,
  customerName: 'John Doe',
  customerEmail: 'john@example.com',
  paymentReference: 'pay-ref-${DateTime.now().millisecondsSinceEpoch}',
  onSuccess: (transaction) {
    print('Monnify payment completed: ${transaction.transactionReference}');
  },
);

🏦 Open Banking Integration

// Initialize Open Banking
final openBankingSDK = AllFintechSDK.initialize(
  provider: FintechProvider.openBanking,
  apiKey: 'your-client-id',
  publicKey: 'your-client-secret',
  baseUrl: 'https://api.openbanking.ng',
);

// Get customer accounts
final accounts = await openBankingSDK.openBanking.data.getAccounts(
  consentToken: 'customer-consent-token',
);

// Show account selector UI
await openBankingSDK.openBanking.ui.showAccountSelector(
  context: context,
  consentToken: 'customer-consent-token',
  onAccountSelected: (account) {
    print('Selected account: ${account.accountNumber}');
  },
  onError: (error) {
    print('Error: $error');
  },
);

// Get transaction history
final transactions = await openBankingSDK.openBanking.data.getAccountTransactions(
  '0123456789',
  from: '2024-01-01',
  to: '2024-12-31',
  consentToken: 'customer-consent-token',
);

🎨 UI Components

Payment Sheets

All providers include beautiful, customizable payment sheets:

// Paystack payment sheet
await sdk.paystack.ui.showPaymentSheet(
  context: context,
  email: 'customer@example.com',
  amount: 50000,
  metadata: {'order_id': '12345'},
  onSuccess: (transaction) => handleSuccess(transaction),
  onError: (error) => handleError(error),
);

// Opay payment sheet with channel selection
await sdk.opay.ui.showPaymentSheet(
  context: context,
  amount: 75000,
  orderNr: 'ORDER-${DateTime.now().millisecondsSinceEpoch}',
  redirectUrl: 'https://yourapp.com/success',
  webServiceUrl: 'https://yourapp.com/webhook',
  standard: 'opay_8.1',
  onSuccess: (transaction) => print('Opay success: ${transaction.transactionId}'),
);

Management Dialogs

// Show transaction status
await sdk.paystack.ui.showTransactionStatusDialog(
  context: context,
  transaction: transaction,
);

// Show customer management
await sdk.flutterwave.ui.showCustomerForm(
  context: context,
  onCustomerCreated: (customer) => print('Customer created: ${customer.id}'),
);

🔧 Advanced Features

Webhook Handling

// Verify webhook signatures
final isValid = await sdk.webhooks.processWebhook(
  payload: request.body,
  signature: request.headers['x-paystack-signature'],
);

if (isValid) {
  // Process webhook data
  print('Webhook verified and processed');
}

Offline Support

// Initialize offline manager
await sdk.initialize();

// Sync offline requests when connection is restored
await sdk.syncOfflineRequests();

Error Handling with Circuit Breaker

try {
  final transaction = await sdk.paystack.data.initializeTransaction(request);
} on FintechException catch (e) {
  if (e is CircuitBreakerOpenException) {
    // Handle circuit breaker open state
    print('Service temporarily unavailable');
  } else {
    // Handle other fintech errors
    print('Payment error: ${e.message}');
  }
}

🏗️ Architecture

Dual Service Pattern

Every provider follows a consistent dual architecture:

// Data-only operations (headless)
final result = await sdk.provider.data.someOperation();

// UI-enabled operations (with widgets)
await sdk.provider.ui.showSomeSheet(context: context);

Provider Switching

// Easy provider switching
FintechProvider currentProvider = FintechProvider.paystack;

switch (currentProvider) {
  case FintechProvider.paystack:
    await sdk.paystack.ui.showPaymentSheet(/* ... */);
    break;
  case FintechProvider.flutterwave:
    await sdk.flutterwave.ui.showPaymentSheet(/* ... */);
    break;
  case FintechProvider.monnify:
    await sdk.monnify.ui.showPaymentSheet(/* ... */);
    break;
}

📋 Supported Providers

Provider	Payments	Transfers	Customers	Subscriptions	Open Banking
Paystack	✅	✅	✅	✅	❌
Flutterwave	✅	✅	✅	✅	❌
Monnify	✅	✅	❌	❌	❌
Opay	✅	❌	❌	❌	❌
Open Banking	❌	❌	❌	❌	✅

🔒 Security Features

Signature Verification - All API requests are signed and verified
OAuth 2.0 - Secure authentication for Open Banking and Monnify
Webhook Security - Automatic signature validation for webhooks
Token Management - Automatic token refresh and secure storage
Encryption - AES-256-CBC encryption for sensitive data

🧪 Testing

// Mock responses for testing
final mockSDK = AllFintechSDK.initialize(
  provider: FintechProvider.paystack,
  apiKey: 'test-key',
  isLive: false, // Always use test mode for development
);

// Test payment flow
await mockSDK.paystack.data.initializeTransaction(
  TransactionRequest(
    email: 'test@example.com',
    amount: 100000,
    reference: 'test-ref-123',
  ),
);

📚 Documentation

🐛 Bug Reports & Feature Requests

Found a bug or have a feature request? We'd love to hear from you!

🔍 Reporting Bugs

Report a Bug →

Before reporting:

Check existing issues
Include provider name, Flutter version, and error details
Provide minimal code example to reproduce

✨ Feature Requests

Request a Feature →

Popular requests:

New fintech provider integrations
Additional UI components
Enhanced security features
Performance improvements

🤝 Contributing

We welcome contributions from the community! Here's how you can help:

Quick Start Contributing

Fork the repository
Clone your fork: git clone https://github.com/your-username/all_fintech_sdk.git
Create a branch: git checkout -b feature/your-feature-name
Make your changes following our coding standards
Test your changes thoroughly
Submit a pull request

Contribution Areas

🏦 New Providers - Add support for more Nigerian fintech APIs
🎨 UI Components - Enhance existing or create new Material Design widgets
🔒 Security - Improve authentication and encryption features
📚 Documentation - Help improve guides and examples
🧪 Testing - Add unit tests and integration tests
🐛 Bug Fixes - Fix issues and improve stability

Development Setup

# Clone the repository
git clone https://github.com/chidiebere-edeh/all_fintech_sdk.git
cd all_fintech_sdk/flutter-sdk/all_fintech_flutter_sdk

# Install dependencies
flutter pub get

# Run tests
flutter test

# Run example app
cd example
flutter run

Coding Standards

Follow Dart/Flutter best practices
Maintain the minimal code principle
Add documentation for public APIs
Include tests for new features
Use conventional commit messages

Pull Request Guidelines

Clear title describing the change
Detailed description of what was changed and why
Link related issues using Fixes #123 or Closes #123
Test coverage for new functionality
Documentation updates if needed

View Contributing Guide →

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

👨‍💻 Author

Chidiebere Edeh

🙏 Acknowledgments

Nigerian fintech ecosystem for driving innovation
Flutter community for excellent tooling and support
All contributors who helped make this SDK possible

⭐ Show Your Support

If this SDK helped you build amazing fintech applications, please give it a ⭐ on GitHub!

Built with ❤️ for the Nigerian fintech ecosystem by Chidiebere Edeh