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}');
  },
);

💰 TransactPay Integration

// Initialize TransactPay (uses encrypted communication)
final transactPaySDK = AllFintechSDK.initialize(
  provider: FintechProvider.transactpay,
  apiKey: 'your-api-key',
  publicKey: 'your-encryption-key',
  isLive: false,
);

// Create order
final order = await transactPaySDK.transactpay.data.createOrder(
  TransactPayOrderRequest(
    reference: 'TXN-${DateTime.now().millisecondsSinceEpoch}',
    amount: 75000,
    currency: 'NGN',
    customer: TransactPayCustomer(
      email: 'customer@example.com',
      firstName: 'John',
      lastName: 'Doe',
    ),
    narration: 'Payment for services',
  ),
);

// Show payment sheet with card/bank options
await transactPaySDK.transactpay.ui.showPaymentSheet(
  context: context,
  amount: 75000,
  customerEmail: 'customer@example.com',
  customerFirstName: 'John',
  customerLastName: 'Doe',
  narration: 'Payment for services',
  onSuccess: (response) {
    print('TransactPay payment successful: ${response.reference}');
  },
  onError: (error) {
    print('Payment failed: $error');
  },
);

// Bank transfer payment
await transactPaySDK.transactpay.ui.showBankTransferSheet(
  context: context,
  orderReference: order.reference,
  amount: 75000,
  onSuccess: (response) {
    print('Bank transfer initiated: ${response.reference}');
  },
);

🏦 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	✅	❌	❌	❌	❌
TransactPay	✅	❌	✅	❌	❌
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

• API Reference
• Provider-Specific Guides
• Migration Guide
• Contributing

🐛 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

1. Fork the repository
2. Clone your fork: git clone https://github.com/your-username/all_fintech_sdk.git
3. Create a branch: git checkout -b feature/your-feature-name
4. Make your changes following our coding standards
5. Test your changes thoroughly
6. 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

• GitHub: @chidiebere-edeh
• Email: chidiebere.edeh@example.com
• LinkedIn: 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