amwal_pay_sdk 1.1.44

Flutter SDK for Amwal Pay integration with secure payment processing, customizable UI, and web WASM support.

Amwal Pay SDK Flutter

A Flutter SDK for integrating Amwal Pay payment solutions into your mobile apps, providing secure, seamless, and customizable payment experiences.

Features

• Multi-Platform Support: Android, iOS, Web, macOS, Windows, Linux
• WASM Compatibility: Full support for WebAssembly compilation (Flutter 3.32.0+)
• Payment Methods: Card payments, wallet payments, QR payments
• Security: Built-in security features and encryption
• Customizable UI: Flexible and customizable payment interfaces

WASM Compatibility

This SDK is fully compatible with Flutter's WebAssembly (WASM) compilation for web platforms. WASM provides:

• Better Performance: Near-native execution speed in web browsers
• Smaller Bundle Size: Optimized compilation for web deployment
• Modern Web Standards: Leverages the latest web technologies

WASM Requirements

• Flutter 3.32.0 or higher
• Dart 3.8.0 or higher
• Modern web browsers with WASM support

Building for WASM

# Build with WASM support
flutter build web --wasm

# Build with JavaScript fallback
flutter build web

Installation

Add this to your package's pubspec.yaml file:

dependencies:
  amwal_pay_sdk: ^1.1.26

Usage

import 'package:amwal_pay_sdk/amwal_pay_sdk.dart';

// Initialize the SDK
await AmwalPaySdk.instance.initSdk(
  settings: AmwalSdkSettings(
    merchantId: 'your_merchant_id',
    terminalId: 'your_terminal_id',
    amount: '100.00',
    currency: 'OMR',
    transactionId: 'unique_transaction_id',
    sessionToken: 'your_session_token',
    environment: Environment.PROD,
    merchantReference: 'optional_merchant_reference', // Optional: Merchant reference for transaction tracking
  ),
);

Optional Parameters

• merchantReference: An optional merchant reference string that can be used to associate the payment with a specific order or reference number in your system. This field is passed through to the Execute endpoints when provided.

Platform Support

Platform	Status	Notes
Android	✅ Full Support	Native Android implementation
iOS	✅ Full Support	Native iOS implementation
Web (JavaScript)	✅ Full Support	Traditional web compilation
Web (WASM)	✅ Full Support	WebAssembly compilation
macOS	✅ Full Support	Native macOS implementation
Windows	✅ Full Support	Native Windows implementation
Linux	✅ Full Support	Native Linux implementation

Web Platform

The web platform supports both JavaScript and WASM compilation modes:

• JavaScript Mode: Traditional compilation for broader browser compatibility
• WASM Mode: Modern compilation for better performance and smaller bundles

Web-Specific Features

• Responsive design for all screen sizes
• Touch and mouse input support
• Progressive Web App (PWA) capabilities
• Cross-browser compatibility

Contributing

Please read CONTRIBUTING.md for details on our code of conduct and the process for submitting pull requests.

License

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

Support

For support and questions:

• GitHub Issues: Create an issue
• Documentation: SDK Documentation
• Email: [e-mail]