Flutter支付集成插件dart_payway的使用

在Flutter应用中集成支付功能时，dart_payway是一个非常实用的插件。本文将详细介绍如何使用 dart_payway插件来创建和处理支付交易。

引入 PaywayTransactionService

首先，我们需要初始化 PaywayTransactionService 对象，并传递必要的商户信息。

var service = PaywayTransactionService(
  merchant: PaywayMerchant(
    merchantID: env['ABA_PAYWAY_MERCHANT_ID'] ?? '',
    merchantApiName: env['ABA_PAYWAY_MERCHANT_NAME'] ?? '',
    merchantApiKey: env['ABA_PAYWAY_API_KEY'] ?? '',
    baseApiUrl: env['ABA_PAYWAY_API_URL'] ?? '',
    refererDomain: "http://mylekha.app",
  ),
);

创建交易示例

接下来，我们通过调用 service.createTransaction 方法来创建一个支付交易。

/// 创建交易
final tranID = service.uniqueTranID();

var _transaction = PaywayCreateTransaction(
  amount: 6.00, // 交易金额
  items: [
    PaywayTransactionItem(name: "商品 1", price: 1, quantity: 1), // 商品详情
    PaywayTransactionItem(name: "商品 2", price: 2, quantity: 1),
    PaywayTransactionItem(name: "商品 3", price: 3, quantity: 1),
  ],
  reqTime: service.uniqueReqTime(), // 请求时间戳
  tranId: tranID, // 交易ID
  email: 'support@mylekha.app', // 用户邮箱
  firstname: 'Miss', // 用户名
  lastname: 'My Lekha', // 用户姓氏
  phone: '010464144', // 用户电话
  option: PaywayPaymentOption.abapay_deeplink, // 支付选项
  shipping: 0.0, // 运费
  returnUrl: "https://mylekha.app", // 返回URL
);

var createResponse = await service.createTransaction(transaction: _transaction);

print(_transaction.amount); // 打印交易金额
print(createResponse.status); // 打印交易状态

生成后端检查URL

我们还可以生成一个用于后端验证的支付检查URL。

final tranID = service.uniqueTranID();

var _transaction = PaywayCreateTransaction(
  amount: 6.00,
  items: [
    PaywayTransactionItem(name: "商品 1", price: 1, quantity: 1),
    PaywayTransactionItem(name: "商品 2", price: 2, quantity: 1),
    PaywayTransactionItem(name: "商品 3", price: 3, quantity: 1),
  ],
  reqTime: service.uniqueReqTime(),
  tranId: tranID,
  email: 'support@mylekha.app',
  firstname: 'Miss',
  lastname: 'My Lekha',
  phone: '010464144',
  option: PaywayPaymentOption.abapay_deeplink,
  shipping: 0.0,
  returnUrl: "https://mylekha.app",
);
var webURI = await service.generateTransactionCheckoutURI(transaction: _transaction);

完整示例代码

以下是一个完整的示例代码，展示了如何在Flutter中使用 dart_payway 插件。

import 'dart:convert';
import 'dart:io';
import 'package:dart_payway/dart_payway.dart' hide debugPrint, kIsWeb;
import 'package:flutter/foundation.dart';
import 'package:flutter/material.dart';
import 'package:flutter_dotenv/flutter_dotenv.dart';

class MyHttpOverrides extends HttpOverrides {
  [@override](/user/override)
  HttpClient createHttpClient(SecurityContext? context) {
    return super.createHttpClient(context)
      ..badCertificateCallback =
          (X509Certificate cert, String host, int port) => true;
  }
}

void main() async {
  HttpOverrides.global = MyHttpOverrides();

  await dotenv.load(fileName: ".env");
  runApp(const MyApp());
}

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: const MyHomePage(title: 'Flutter Demo Home Page'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key, required this.title});

  final String title;

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

class _MyHomePageState extends State<MyHomePage> {
  late PaywayTransactionService service;
  String? tranID = null;

  [@override](/user/override)
  void initState() {
    service = PaywayTransactionService(
      merchant: PaywayMerchant(
        merchantID: dotenv.env['ABA_PAYWAY_MERCHANT_ID'] ?? '',
        merchantApiName: dotenv.env['ABA_PAYWAY_MERCHANT_NAME'] ?? '',
        merchantApiKey: dotenv.env['ABA_PAYWAY_API_KEY'] ?? '',
        baseApiUrl: dotenv.env['ABA_PAYWAY_API_URL'] ?? '',
        refererDomain: "http://localhost",
      ),
    );
    super.initState();
    kIsWeb;
  }

  Future<void> createTransaction() async {
    setState(() {
      tranID = service.uniqueTranID();
    });

    var transaction = PaywayCreateTransaction(
      amount: 10.00,
      items: [
        PaywayTransactionItem(name: "商品 1", price: 2, quantity: 1),
        PaywayTransactionItem(name: "商品 2", price: 3, quantity: 1),
        PaywayTransactionItem(name: "商品 3", price: 5, quantity: 1),
      ],
      reqTime: service.uniqueReqTime(),
      tranId: tranID!,
      email: 'support@mylekha.app',
      firstname: 'Miss',
      lastname: 'My Lekha',
      phone: '010464144',
      option: PaywayPaymentOption.abapay_khqr_deeplink,
      shipping: 0.0,
      returnUrl:
          "https://xdgacmihblkqdexzbmkw.supabase.co/functions/v1/payway_checkout_success",
      continueSuccessUrl: "https://mylekha.app",
      returnParams: EncoderService.base64_encode(
          {"booking_id": "0032153b-8df2-40a3-b533-37622e7ecd37"}),
      customFields: EncoderService.base64_encode(
          {"booking_id": "0032153b-8df2-40a3-b533-37622e7ecd37"}),
    );

    try {
      var createResponse = await service.createTransaction(
          transaction: transaction, enabledLogger: true);
      debugPrint(createResponse.toString());
    } catch (e) {}
  }

  Future<void> checkTransaction() async {
    final transaction = PaywayCheckTransaction(
      reqTime: service.uniqueReqTime(),
      tranId: tranID!,
    );

    try {
      var createResponse = await service.checkTransaction(
          transaction: transaction, enabledLogger: true);
      debugPrint(createResponse.toString());
    } catch (e) {}
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        backgroundColor: Theme.of(context).colorScheme.inversePrimary,
        title: Text(widget.title),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            TextButton(
              onPressed: createTransaction,
              child: Text("创建交易"),
            ),
            TextButton(
              onPressed: checkTransaction,
              child: Text("检查交易"),
            ),
          ],
        ),
      ),
    );
  }
}