Flutter未知功能插件mvola的使用（由于介绍为undefined，故以“未知功能”代替）

Flutter未知功能插件mvola的使用

MVolaAPI dart包

这是一个可以在Dart或Flutter客户端中与MVola API交互的包。

功能

它允许你进行支付、查看交易状态以及获取先前交易的详细信息。

开始使用

该包依赖于uuid和http包。

命令行安装

在终端中输入以下命令：

dart pub add mvola

或者，如果你正在添加到一个Flutter项目中：

flutter pub add mvola

pubspec.yaml安装

在你的pubspec.yaml文件中添加以下行：

dependencies:
  mvola:

更多信息可以在pub.dev找到，这是Dart和Flutter的官方包仓库。

使用方法

首先导入库：

import 'package:mvola/mvola.dart';

然后创建一个MVolaClient实例，并提供请求的基本URL（开发环境为https://devapi.mvola.mg，生产环境为https://api.mvola.mg），以及消费者密钥和消费者密钥。可选地，可以提供回调URL，API会在交易成功或失败时向该URL发送通知。

var mvola = MVolaClient(baseUrl, consumerKey, consumerSecret);

consumerKey和consumerSecret可以在创建应用后在MVola开发者门户上找到。

接下来，你需要生成访问令牌以便进行交易。你可以将其存储在一个变量中供后续使用，或者直接调用方法设置它。

await mvola.generateAccessToken();

现在，你可以进行交易、获取交易状态或获取交易详情。

// 进行交易
var transactionResponse = await mvola.initTransaction(
  partnerName: 'name',
  partnerNumber: '0343500004',
  creditNumber: '0343500004',
  amount: 5000,
  debitNumber: '0343500003',
  description: 'short description',
);

// 获取交易状态
var transactionStatus = await mvola.getTransactionStatus(
  transactionResponse.serverCorrelationId,
  '0343500004',
  'name',
);

// 获取交易详情
var transaction = await mvola.getTransactionDetail(
  serverCorrelationId,
  "name",
  "0343500004",
);

在开发环境中，只能使用0343500004和0343500003作为商户或客户号码。

完整示例代码

完整的示例代码可以在这里找到。

import 'package:mvola/mvola.dart';
import 'package:dotenv/dotenv.dart';
import 'package:mvola/src/constants.dart';

void main() async {
  var env = DotEnv(includePlatformEnvironment: true)..load();

  var mvola = MVolaClient(
    env['DEV_ENV'] == '1' ? sandboxUrl : productionUrl,
    env['CONSUMER_KEY']!,
    env['CONSUMER_SECRET']!,
  );

  var token = await mvola.generateAccessToken();
  print(token);

  var transactionResponse = await mvola.initTransaction(
    partnerName: 'name',
    partnerNumber: '0343500004',
    creditNumber: '0343500004',
    amount: 5000,
    debitNumber: '0343500003',
    description: 'short description',
  );

  print(transactionResponse);

  // 我们必须等待交易被批准才能获取ID以获取详情
  await Future.delayed(Duration(seconds: 30));

  var transactionStatus = await mvola.getTransactionStatus(
    transactionResponse.serverCorrelationId,
    '0343500003',
    'name',
  );
  print(transactionStatus);

  var transactionDetails = await mvola.getTransactionDetail(
    transactionStatus.transactionReference,
    'name',
    '0343500004',
  );
  print(transactionDetails);
}