Flutter生成UUID与M-Pesa集成插件uuid_mpesa的使用

简介

uuid_mpesa 是一个用于 Flutter 的 Dart 库，旨在帮助开发者轻松生成 UUID 并与 M-Pesa 集成。该库提供了便捷的方法来生成唯一的标识符，并支持与 M-Pesa API 的交互。

使用方法

安装

首先，在 pubspec.yaml 文件中添加以下依赖项：

dependencies:
  uui_mpesa: ^版本号

然后运行以下命令以安装依赖项：

flutter pub get

导入库

在您的 Dart 文件中导入 uuid_mpesa 库：

import 'package:uui_mpesa/uui_mpesa.dart';

生成UUID

使用 UUIDMpesa.referencia 方法生成指定长度的 UUID。例如，生成一个长度为 10 的 UUID：

void main() {
  // 生成长度为 10 的 UUID
  var a = UUIDMpesa.referencia(10);

  // 输出生成的 UUID
  print("生成的 UUID: $a");
}

代码解释

• UUIDMpesa.referencia(length)：此方法会根据指定的长度生成一个随机字符串作为 UUID。
• print("生成的 UUID: $a")：打印生成的 UUID 值。

与M-Pesa集成

假设您已经配置好 M-Pesa API 的相关参数（如 Consumer Key、Consumer Secret 和沙箱 URL），可以使用 uuid_mpesa 插件进行支付请求。以下是一个完整的示例：

import 'dart:convert';
import 'package:http/http.dart' as http;
import 'package:uui_mpesa/uui_mpesa.dart';

void main() async {
  // 生成订单参考号
  String referencia = UUIDMpesa.referencia(10);

  // M-Pesa API 参数
  final String consumerKey = "您的Consumer Key";
  final String consumerSecret = "您的Consumer Secret";
  final String sandboxUrl = "https://sandbox.safaricom.co.ke";

  // 获取访问令牌
  String token = await getAccessToken(consumerKey, consumerSecret);

  // 发起支付请求
  Map<String, dynamic> response = await requestSTKPush(
    token,
    sandboxUrl,
    referencia,
    "2547XXXXXXXX",
    "1",
    "http://yourcallbackurl.com"
  );

  // 打印支付请求结果
  print("支付请求结果: ${response.toString()}");
}

// 获取访问令牌
Future<String> getAccessToken(String consumerKey, String consumerSecret) async {
  final String auth = base64Encode(utf8.encode('$consumerKey:$consumerSecret'));
  final response = await http.post(
    Uri.parse("$sandboxUrl/oauth/v1/generate?grant_type=client_credentials"),
    headers: {
      "Authorization": "Basic $auth",
    },
  );
  if (response.statusCode == 200) {
    return jsonDecode(response.body)['access_token'];
  } else {
    throw Exception("Failed to get access token");
  }
}

// 请求STK Push
Future<Map<String, dynamic>> requestSTKPush(
  String token,
  String sandboxUrl,
  String referencia,
  String phoneNumber,
  String amount,
  String callbackURL,
) async {
  final response = await http.post(
    Uri.parse("$sandboxUrl/mpesa/stkpush/v1/processrequest"),
    headers: {
      "Authorization": "Bearer $token",
      "Content-Type": "application/json",
    },
    body: jsonEncode({
      "BusinessShortCode": "174379", // 替换为您的业务短码
      "Password": "MTIzNDU2Nzg5MQ==", // 替换为您的密码
      "Timestamp": "20230801", // 替换为当前日期
      "TransactionType": "CustomerPayBillOnline",
      "Amount": amount,
      "PartyA": phoneNumber,
      "PartyB": "174379", // 替换为您的业务短码
      "PhoneNumber": phoneNumber,
      "CallBackURL": callbackURL,
      "AccountReference": referencia,
      "TransactionDesc": "测试支付",
    }),
  );

  if (response.statusCode == 200) {
    return jsonDecode(response.body);
  } else {
    throw Exception("Failed to request STK Push");
  }
}