Novac Payment Plugin #

Official Flutter plugin for Novac Payment Gateway. Accept payments seamlessly in your Flutter apps with support for cards, bank transfers, and mobile money.

Features #

• 💳 Accept card payments (Visa, Mastercard, Verve)
• 🏦 Bank transfer payments
• 📱 Mobile money support
• 🎨 Customizable checkout UI
• ✅ Payment verification
• 🔒 Secure and PCI-DSS compliant

Installation #

Add this to your pubspec.yaml:

dependencies:
  novac_payment_plugin: ^1.0.0

Then run:

flutter pub get

Platform Setup #

iOS #

Add the following to your ios/Runner/Info.plist to enable deep linking:

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

Minimum iOS version: 12.0

Android #

Add the following to your android/app/src/main/AndroidManifest.xml:

<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="yourappscheme" />
</intent-filter>

Minimum SDK version: 21

Usage #

1. Initialize the SDK #

Initialize the plugin with your API key from the Novac Dashboard:

import 'package:novac_payment_plugin/novac_payment_plugin.dart';

await NovacPaymentPlugin.initialize(
  apiKey: 'your_api_key',
  primaryColor: '#007AFF',      // Optional: Customize theme
  backgroundColor: '#FFFFFF',   // Optional
  buttonTextColor: '#FFFFFF',   // Optional
);

2. Launch Checkout #

Start a payment flow:

final result = await NovacPaymentPlugin.launchCheckout(
  amount: 5000,                 // Amount in smallest currency unit
  currency: 'NGN',
  redirectUrl: 'https://yourapp.com/payment-complete',
  customerData: CustomerData(
    email: 'customer@example.com',
    firstName: 'John',
    lastName: 'Doe',            // Optional
    phoneNumber: '+2348012345678', // Optional
  ),
  customizationData: CustomizationData(
    logoUrl: 'https://yourcompany.com/logo.png',
    paymentDescription: 'Payment for Order #12345',
    checkoutModalTitle: 'Complete Payment',
  ),
  transactionReference: 'unique-reference-123', // Optional: Auto-generated if not provided
);

// Handle the result
if (result.isSuccess) {
  print('Payment successful! Transaction ID: ${result.transactionId}');
} else if (result.isCancelled) {
  print('Payment cancelled by user');
} else {
  print('Payment failed: ${result.errorMessage}');
}

3. Verify Payment #

Verify a payment status:

final verification = await NovacPaymentPlugin.verifyPayment('transaction-reference');

print('Status: ${verification.status}');
print('Amount: ${verification.amount}');
print('Currency: ${verification.currency}');

API Reference #

NovacPaymentPlugin #

CustomerData #

CustomizationData #

PaymentResult #

VerificationResult #

Testing #

Use test API keys from your Novac dashboard for development:

// Use test key for development
await NovacPaymentPlugin.initialize(
  apiKey: 'nc_test_xxxxxxxxxxxx',
);

Test card numbers:

• Success: 5555 5555 5555 4444
• Failed: 1234 5678 9876 5432

OTP for testing

• 123456

Error Handling #

try {
  final result = await NovacPaymentPlugin.launchCheckout(...);
  
  if (result.isSuccess) {
    // Handle success
  } else if (result.isCancelled) {
    // Handle cancellation
  } else {
    // Handle failure
    print('Error: ${result.errorCode} - ${result.errorMessage}');
  }
} catch (e) {
  // Handle unexpected errors
  print('Unexpected error: $e');
}

Support #

• 📧 Email: support@novacpayment.com
• 📖 Documentation: https://docs.novacpayment.com
• 🐛 Issues: https://github.com/novac/novac-flutter-plugin/issues

License #

MIT License - see LICENSE for details.