Flutter支付插件yenepay_flutter的使用

yenepay_flutter 是一个用于通过Yenepay支付网关进行支付的Flutter插件。它支持Android和iOS平台。

安装

要使用该插件，你需要在 pubspec.yaml 文件中添加 yenepay_flutter 作为依赖项。

对于Android

你需要在 android/app/src/main/AndroidManifest.xml 文件中声明以下意图过滤器：

<manifest ...>
  <!-- ... 其他标签 -->
  <!-- 提供API级别30及以上所需的可见性配置 -->
  <queries>
      <intent>
          <action android:name="android.intent.action.VIEW" />
          <data android:scheme="https" />
      </intent>
  </queries>

  <application ...>
    <activity ...>
      <!-- ... 其他标签 -->

      <!-- 深度链接以监听yenepay支付状态 -->
      <intent-filter>
              <action android:name="android.intent.action.VIEW" />
              <category android:name="android.intent.category.DEFAULT" />
              <category android:name="android.intent.category.BROWSABLE" />
              <!-- 接受URI格式为YOUR_SCHEME://YOUR_HOST 的请求 -->
              <data
                  android:scheme="yenepayflutter"
                  android:host="success" />

              <data
                  android:scheme="yenepayflutter"
                  android:host="cancel" />

              <data
                  android:scheme="yenepayflutter"
                  android:host="failure" />
      </intent-filter>
    </activity>
  </application>
</manifest>

对于iOS

你需要在 ios/Runner/Info.plist 文件中添加以下URL方案条目：

<key>LSApplicationQueriesSchemes</key>
<array>
  <string>https</string>
  <string>http</string>
</array>

为了监听yenepay支付状态，你还需要在 ios/Runner/Info.plist 文件中声明方案（或者通过Xcode的目标信息编辑器，在URL类型下）：

<!-- ... 其他标签 -->
<plist>
<dict>
  <!-- ... 其他标签 -->
  <key>CFBundleURLTypes</key>
  <array>
    <dict>
      <key>CFBundleTypeRole</key>
      <string>Editor</string>
      <key>CFBundleURLName</key>
      <string>[REPLACE_WITH_YOU_APP_BUNDLE_ID]</string>
      <key>CFBundleURLSchemes</key>
      <array>
        <string>yenepayflutter</string>
      </array>
    </dict>
  </array>
  <!-- ... 其他标签 -->
</dict>
</plist>

使用

首先在应用启动时初始化 yenepay_flutter：

import 'package:flutter/material.dart';
import 'package:yenepay_flutter/models/enums.dart';
import 'package:yenepay_flutter/models/yenepay_item.dart';
import 'package:yenepay_flutter/models/yenepay_parameters.dart';
import 'package:yenepay_flutter/yenepay_flutter.dart';

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      home: const HomePage(),
    );
  }
}

class HomePage extends StatefulWidget {
  const HomePage({Key? key}) : super(key: key);

  [@override](/user/override)
  _HomePageState createState() => _HomePageState();
}

class _HomePageState extends State<HomePage> {
  [@override](/user/override)
  void initState() {
    YenepayFlutter.init(
      onPaymentSuccess: (List<YenepayItem> items) {
        print("onPaymentSuccess ${items.length} ${items[0].itemName}");
      },
      onPaymentCancel: (List<YenepayItem> items) {
        print("onPaymentCancel ${items.length} ${items[0].itemName}");
      },
      onPaymentFailure: (List<YenepayItem> items) {
        print("onPaymentFailure ${items.length} ${items[0].itemName}");
      },
      onError: (e) {
        print("onError ${e.toString()}");
      },
    );

    // 启动支付流程
    YenepayFlutter.startPayment(
      isTestEnv: true,
      yenepayParameters: YenepayParameters(
        process: YenepayProcess.Express,
        merchantId: "SB1356",
        items: [
          YenepayItem(
            itemId: '1',
            unitPrice: 12.2,
            quantity: 2,
            itemName: 'test',
          ),
        ],
      ),
    );

    super.initState();
  }

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Container();
  }
}

最后别忘了在应用关闭时调用 dispose 方法：

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