Flutter支付插件aangaraa_pay_flutter的使用

Flutter支付插件aangaraa_pay_flutter的使用

Aangaraa Pay Flutter Plugin

这是一个用于在Flutter应用中轻松集成MTN Mobile Money和Orange Money支付服务的插件，适用于喀麦隆市场。

安装

在pubspec.yaml文件中添加依赖：

dependencies:
  aangaraa_pay_flutter: ^0.0.1

或者直接从GitHub安装：

dependencies:
  aangaraa_pay_flutter:
    git:
      url: https://github.com/votre-username/aangaraa_pay_flutter.git
      ref: main

运行以下命令以安装依赖：

flutter pub get

配置

在使用插件之前，需要初始化它，并提供API密钥和API基础URL。

import 'package:aangaraa_pay_flutter/aangaraa_pay_flutter.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({Key? key}) : super(key: key);

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: HomeScreen(),
    );
  }
}

class HomeScreen extends StatefulWidget {
  [@override](/user/override)
  _HomeScreenState createState() => _HomeScreenState();
}

class _HomeScreenState extends State<HomeScreen> {
  final AangaraaPayFlutter aangaraaPay = AangaraaPayFlutter();

  [@override](/user/override)
  void initState() {
    super.initState();
    _initializePlugin();
  }

  Future<void> _initializePlugin() async {
    await aangaraaPay.initialize(
      apiKey: 'VOTRE_CLE_API',
      baseUrl: 'YOUR_API_BASE_URL',
    );
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Aangaraa Pay Example'),
      ),
      body: Center(
        child: Text('Initialized!'),
      ),
    );
  }
}

使用

执行支付

调用initiatePayment方法来发起支付请求。需要指定运营商（MTN或Orange）、金额、电话号码等信息。

Future<void> _makePayment(String operator) async {
  try {
    final result = await aangaraaPay.initiatePayment(
      operator: operator, // 指定运营商
      amount: '1000', // 支付金额
      currency: 'XAF', // 货币类型
      phoneNumber: '237600000000', // 用户电话号码
      description: 'Test payment', // 支付描述
      transactionId: DateTime.now().millisecondsSinceEpoch.toString(), // 唯一交易ID
      returnUrl: 'YOUR_RETURN_URL', // 返回URL
      notifyUrl: 'YOUR_NOTIFY_URL', // 通知URL
      apiKey: 'YOUR_API_KEY', // API密钥
      baseUrl: 'YOUR_API_BASE_URL', // API基础URL
    );

    print('Status: ${result['status']}');
    print('Transaction ID: ${result['transaction_id']}');
  } catch (e) {
    print('Error: $e');
  }
}

参数说明

查询交易状态

可以使用checkTransactionStatus方法查询支付状态。

Future<void> _checkTransactionStatus(String transactionId) async {
  try {
    final status = await aangaraaPay.checkTransactionStatus(
      payToken: transactionId, // 交易ID
      appKey: 'YOUR_API_KEY', // API密钥
      baseUrl: 'YOUR_API_BASE_URL', // API基础URL
    );

    print('Status: ${status['status']}');
  } catch (e) {
    print('Error: $e');
  }
}

完整示例

以下是完整的代码示例，包含用户输入手机号和金额，并选择运营商进行支付的功能。

import 'package:flutter/material.dart';
import 'package:aangaraa_pay_flutter/aangaraa_pay_flutter.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({Key? key}) : super(key: key);

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: HomeScreen(),
    );
  }
}

class HomeScreen extends StatefulWidget {
  [@override](/user/override)
  _HomeScreenState createState() => _HomeScreenState();
}

class _HomeScreenState extends State<HomeScreen> {
  final AangaraaPayFlutter aangaraaPay = AangaraaPayFlutter();
  final TextEditingController _phoneController = TextEditingController();
  final TextEditingController _amountController = TextEditingController();
  String _paymentStatus = '';

  [@override](/user/override)
  void initState() {
    super.initState();
    _initializePlugin();
  }

  Future<void> _initializePlugin() async {
    await aangaraaPay.initialize(
      apiKey: 'VOTRE_CLE_API',
      baseUrl: 'YOUR_API_BASE_URL',
    );
  }

  Future<void> _makePayment(String operator) async {
    try {
      setState(() {
        _paymentStatus = 'Processing $operator Payment...';
      });

      final result = await aangaraaPay.initiatePayment(
        operator: operator,
        amount: _amountController.text,
        currency: 'XAF',
        phoneNumber: _phoneController.text,
        description: 'Test payment',
        transactionId: DateTime.now().millisecondsSinceEpoch.toString(),
        returnUrl: 'YOUR_RETURN_URL',
        notifyUrl: 'YOUR_NOTIFY_URL',
        apiKey: 'YOUR_API_KEY',
        baseUrl: 'YOUR_API_BASE_URL',
      );

      setState(() {
        _paymentStatus = '${operator} Payment Status: ${result['status']}';
      });

      // 查询最终状态
      if (result['transaction_id'] != null) {
        await Future.delayed(const Duration(seconds: 5));
        final status = await aangaraaPay.checkTransactionStatus(
          payToken: result['transaction_id'],
          appKey: 'YOUR_API_KEY',
          baseUrl: 'YOUR_API_BASE_URL',
        );
        setState(() {
          _paymentStatus = 'Final Status: ${status['status']}';
        });
      }
    } catch (e) {
      setState(() {
        _paymentStatus = 'Error: $e';
      });
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Aangaraa Pay Example'),
      ),
      body: Padding(
        padding: const EdgeInsets.all(16.0),
        child: Column(
          children: [
            TextField(
              controller: _phoneController,
              decoration: InputDecoration(
                labelText: 'Phone Number',
                hintText: 'Enter phone number',
              ),
              keyboardType: TextInputType.phone,
            ),
            SizedBox(height: 16),
            TextField(
              controller: _amountController,
              decoration: InputDecoration(
                labelText: 'Amount',
                hintText: 'Enter amount in XAF',
              ),
              keyboardType: TextInputType.number,
            ),
            SizedBox(height: 24),
            Row(
              mainAxisAlignment: MainAxisAlignment.spaceEvenly,
              children: [
                ElevatedButton(
                  onPressed: () => _makePayment('MTN'),
                  child: Text('Pay with MTN'),
                ),
                ElevatedButton(
                  onPressed: () => _makePayment('Orange_Cameroon'),
                  child: Text('Pay with Orange'),
                ),
              ],
            ),
            SizedBox(height: 24),
            Text(
              _paymentStatus,
              style: TextStyle(fontSize: 16),
              textAlign: TextAlign.center,
            ),
          ],
        ),
      ),
    );
  }

  [@override](/user/override)
  void dispose() {
    _phoneController.dispose();
    _amountController.dispose();
    super.dispose();
  }
}