A comprehensive solution for processing payments with Ngenius in your Flutter app.

Motivation

Ngenius Flutter SDK simplifies the integration of Ngenius payment gateway in Flutter applications by providing seamless support for card payments, 3DS and 3DS2 authentication, and customizable UI components.

Index

• Motivation
• Features
• Getting Started
• Usage
• Configuration
  • Android
  • iOS
  • Test Cards
  • Known Issues
• Additional Information
• License
• Issues and Feedback
• Contributing

Features

• Seamless integration with Ngenius payment gateway
• Support for card payments
• 3DS and 3DS2 authentication support
• Customizable UI components

Getting Started

To use this plugin, add ngenius_sdk as a dependency in your pubspec.yaml file.

dependencies:
  ngenius_sdk: ^0.0.8

Usage

Import the package in your Dart code:

import 'package:ngenius_sdk/ngenius_sdk.dart';

To initiate a payment, use the NgeniusCheckout widget:

NgeniusCheckout(
  apiUrl: 'YOUR_API_URL',
  apiKey: 'YOUR_API_KEY',
  outletId: 'YOUR_OUTLET_ID',
  currency: 'CURRENCY',
  amount: 'AMOUNT', // Amount as an integer
  onPaymentCreated: () {
    // Handle successful payment creation
  },
  // Optional
  onError: () {
    // Handle payment errors
  },
)

Configuration

Ensure you have the following permissions set up in your project:

Android

Add the internet permission to your AndroidManifest.xml:

<uses-permission android:name="android.permission.INTERNET"/>

iOS

No additional configuration required for iOS.

Test Cards

• 4012001037141112: 3DS activated
• 4792445612017070: 3DS declined
• 5457210001000019: 3DS2 activated
• 4000000000000002: 3DS2 declined

Known Issues

• Amex is not working
• Proper error message display needs to be built

Additional Information

For more details on using the Ngenius SDK, please refer to the official documentation.

License

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

Issues and Feedback

Please file issues, bugs, or feature requests in our issue tracker.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.