Flutter支付插件flutter_kgo_vnpay的使用

Flutter支付插件flutter_kgo_vnpay的使用

flutter_kgo_vnpay 是一个用于连接 VNPAY SDK 的 Flutter 插件。本文档将指导你如何在 Flutter 应用中使用该插件。

获取开始

此项目旨在帮助你连接到 VNPAY SDK。VNPAY 是越南的一个在线支付平台，你可以通过此插件集成其支付功能到你的 Flutter 应用中。

iOS 配置

在 ios/Runner/Info.plist 文件中添加以下配置：

<key>NSAppTransportSecurity</key>
<dict>
    <key>NSAllowsArbitraryLoads</key>
    <true/>
    <key>NSAllowsArbitraryLoadsInWebContent</key>
    <true/>
</dict>

<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleTypeRole</key>
        <string>Editor</string>
        <key>CFBundleURLName</key>
        <string>vnpayxxx</string>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>vnpayxxx</string>
        </array>
    </dict>
</array>

Android 配置

对于 Android 平台，你需要进行一些额外的配置，但具体步骤未在文档中明确说明。通常情况下，你需要确保 AndroidManifest.xml 文件中包含必要的权限和配置。

使用方法

1. 添加依赖

在项目的 pubspec.yaml 文件中添加 flutter_kgo_vnpay 依赖：

dependencies:
  flutter_kgo_vnpay: ^0.0.2+3

2. 安装依赖

运行以下命令安装依赖：

$ flutter pub get

完整示例代码

以下是一个完整的示例代码，展示了如何在 Flutter 应用中使用 flutter_kgo_vnpay 插件来实现支付功能。

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

import 'package:flutter/services.dart';
import 'package:flutter_kgo_vnpay/flutter_kgo_vnpay.dart';

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

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

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  String _platformVersion = 'Unknown';
  final _flutterKgoVnpayPlugin = FlutterKgoVnpay();

  [@override](/user/override)
  void initState() {
    super.initState();
    initPlatformState();
  }

  // 异步方法，初始化平台状态
  Future<void> initPlatformState() async {
    String platformVersion;
    // 可能会抛出 PlatformException，所以我们使用 try/catch 来处理
    try {
      platformVersion = await _flutterKgoVnpayPlugin.getPlatformVersion() ?? 
          'Unknown platform version';
    } on PlatformException {
      platformVersion = 'Failed to get platform version.';
    }

    // 如果小部件从树中移除时异步消息还在飞行，则丢弃回复而不是调用 setState 更新非存在的外观。
    if (!mounted) return;

    setState(() {
      _platformVersion = platformVersion;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Plugin example app'),
        ),
        body: Center(
          child: Column(
            children: [
              // 按钮用于触发支付流程
              TextButton(
                onPressed: () {
                  _flutterKgoVnpayPlugin.show(
                    paymentUrl: 
                      'https://sandbox.vnpayment.vn/paymentv2/vpcpay.html?vnp_Amount=93830000&vnp_Command=pay&vnp_CreateDate=20220713172638&vnp_CurrCode=VND&vnp_IpAddr=27.72.98.245&vnp_Locale=vn&vnp_OrderInfo=Mua+bh+tnds+cho+xe+%2C+ma+don%3A+220713LNZHKU&vnp_ReturnUrl=httpsO://kgo.life&vnp_TmnCode=xxx&vnp_TxnRef=1000013&vnp_Version=2.1.0&vnp_SecureHash=xxxx',
                    tmnCode: 'kgoxxx',
                    scheme: 'kgo-vnpay',
                  );
                },
                child: Text('Nạp tiền'), // 文本按钮显示“Nạp tiền”，意为“充值”
              ),
              // 显示当前平台版本
              Text('Running on: $_platformVersion\n'),
            ],
          ),
        ),
      ),
    );
  }
}