Flutter支付集成插件jazzcash_flutter的使用

安装

1. 添加依赖

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

dependencies:
  jazzcash_flutter: <最新版本>

2. 安装依赖

你可以通过命令行安装包：

使用 pub:

$ pub get

使用 flutter:

$ flutter pub get

3. 导入包

在你的 Dart 代码中导入以下内容：

import 'package:jazzcash_flutter/jazzcash_flutter.dart';

使用

jazzcash_flutter 是一个用于 Flutter 应用程序的支付网关集成包，可以使用 JazzCash 钱包和借记卡发起支付过程。启动支付过程如下：

Future _payViaJazzCash(ProductModel element, BuildContext c) async {
  try {
    // 初始化 JazzCashFlutter 实例
    JazzCashFlutter jazzCashFlutter = JazzCashFlutter(
      merchantId: "Your Merchant Id",
      merchantPassword: "Your Merchant Password",
      integritySalt: "Your Integrity Salt here",
      isSandbox: true,
    );

    // 获取当前日期时间
    DateTime date = DateTime.now();

    // 创建支付数据模型
    JazzCashPaymentDataModelV1 paymentDataModelV1 = JazzCashPaymentDataModelV1(
      ppAmount: '${element.price}', // 支付金额
      ppBillReference: 'refbill${date.year}${date.month}${date.day}${date.hour}${date.millisecond}', // 订单号
      ppDescription: 'Product details  ${element.name} - ${element.price}', // 描述
      ppMerchantID: "Your Merchant Password", // 商户ID
      ppPassword: "Your Merchant Password", // 密码
      ppReturnURL: "Your Return Url", // 返回URL
    );

    // 开始支付流程
    jazzCashFlutter.startPayment(paymentDataModelV1: paymentDataModelV1, context: context).then((_response) {
      // 检查支付是否成功
      _checkIfPaymentSuccessfull(_response, element, context).then((res) {
        // res 是从返回URL接收到的响应
        return res;
      });

      setState(() {});
    });
  } catch (err) {
    print("Error in payment $err");
    // CommonFunctions.CommonToast(
    //   message: "Error in payment $err",
    // );
    return false;
  }
}

示例代码

以下是完整的示例代码，展示了如何使用 jazzcash_flutter 插件进行支付。

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

// 产品模型类
class ProductModel {
  String? productName;
  String? productPrice;

  ProductModel(this.productName, this.productPrice);
}

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

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Jazzcash Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const MyHomePage(),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key});

  [@override](/user/override)
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {

  String paymentStatus = "pending";
  ProductModel productModel = ProductModel("Product 1", "100");
  String integritySalt = "Your Integrity salt";
  String merchantID = "Your Merchant Id";
  String merchantPassword = "Your Merchant Password";
  String transactionUrl = "Your Return Url";

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text("JazzCash Flutter Example"),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            Text("Product Name : ${productModel.productName}"),
            Text("Product Price : ${productModel.productPrice}"),
            ElevatedButton(
              onPressed: () {
                _payViaJazzCash(productModel, context);
              },
              child: const Text("Purchase Now !")
            )
          ],
        ),
      ),
    );
  }

  Future _payViaJazzCash(ProductModel element, BuildContext c) async {
    try {
      // 初始化 JazzCashFlutter 实例
      JazzCashFlutter jazzCashFlutter = JazzCashFlutter(
        merchantId: merchantID,
        merchantPassword: merchantPassword,
        integritySalt: integritySalt,
        isSandbox: true,
      );

      // 获取当前日期时间
      DateTime date = DateTime.now();

      // 创建支付数据模型
      JazzCashPaymentDataModelV1 paymentDataModelV1 = JazzCashPaymentDataModelV1(
        ppAmount: '${element.productPrice}', // 支付金额
        ppBillReference: 'refbill${date.year}${date.month}${date.day}${date.hour}${date.millisecond}', // 订单号
        ppDescription: 'Product details  ${element.productName} - ${element.productPrice}', // 描述
        ppMerchantID: merchantID, // 商户ID
        ppPassword: merchantPassword, // 密码
        ppReturnURL: transactionUrl, // 返回URL
      );

      // 开始支付流程
      jazzCashFlutter.startPayment(paymentDataModelV1: paymentDataModelV1, context: context).then((_response) {
        print("response from jazzcash $_response");

        // _checkIfPaymentSuccessfull(_response, element, context).then((res) {
        //   // res 是从返回URL接收到的响应
        //   return res;
        // });

        setState(() {});
      });
    } catch (err) {
      print("Error in payment $err");
      // CommonFunctions.CommonToast(
      //   message: "Error in payment $err",
      // );
      return false;
    }
  }
}