Flutter支付集成插件flutter_tap_payment的使用

Flutter支付集成插件flutter_tap_payment的使用

本README描述了该包。如果您将此包发布到pub.dev，则此README的内容将出现在您的包的首页上。

对于如何编写一个好的包README的指南，请参阅撰写包页面。

对于开发包的一般信息，请参阅Dart指南创建库包和Flutter指南开发包和插件。

功能

这是一个轻量级的Tap Payment SDK，适用于flutter。它利用了Flutter Webview，以完成支付过程。正如一句简单的咒语，却非常坚不可摧。

使用方法

在添加包到您的pubspec.yaml文件后，请确保导入它：

import 'package:flutter_tap_payment/flutter_tap_payment.dart';

您可以在/example文件夹中查看一个简单的示例。

完整示例代码

以下是在Flutter项目中使用flutter_tap_payment插件的完整示例代码。请确保替换其中的占位符（如YOUR_API_KEY等）为您自己的实际值。

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

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

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

  // 这个小部件是你的应用的根。
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Tap Payment',
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: const MyHomePage(title: 'Flutter Tap Payment Example'),
    );
  }
}

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> {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: Center(
        child: TextButton(
          onPressed: () => {
            // 导航到支付页面
            Navigator.of(context).push(
              MaterialPageRoute(
                builder: (BuildContext context) => TapPayment(
                  apiKey: "YOUR_API_KEY", // 替换为您的API密钥
                  redirectUrl: "http://your_website.com/redirect_url", // 替换为您的重定向URL
                  postUrl: "http://your_website.com/post_url", // 替换为您的POST URL
                  paymentData: const {
                    "amount": 10, // 支付金额
                    "currency": "OMR", // 货币类型
                    "threeDSecure": true, // 是否启用3D安全验证
                    "save_card": false, // 是否保存卡信息
                    "description": "Test Description", // 描述信息
                    "statement_descriptor": "Sample", // 交易描述
                    "metadata": {"udf1": "test 1", "udf2": "test 2"}, // 元数据
                    "reference": {
                      "transaction": "txn_0001", // 事务ID
                      "order": "ord_0001" // 订单ID
                    },
                    "receipt": {"email": false, "sms": true}, // 发送收据
                    "customer": {
                      "first_name": "test", // 客户名字
                      "middle_name": "test", // 客户中间名
                      "last_name": "test", // 客户姓氏
                      "email": "test@test.com", // 客户邮箱
                      "phone": {
                        "country_code": "965", // 国家码
                        "number": "50000000" // 电话号码
                      }
                    },
                    // "merchant": {"id": ""}, // 商家ID
                    "source": {"id": "src_card"}, // 源ID
                    // "destinations": {
                    //   "destination": [
                    //     {"id": "480593777", "amount": 2, "currency": "KWD"},
                    //     {"id": "486374777", "amount": 3, "currency": "KWD"}
                    //   ]
                    // }
                  },
                  onSuccess: (Map params) async {
                    print("onSuccess: $params"); // 成功回调
                  },
                  onError: (error) {
                    print("onError: $error"); // 错误回调
                  },
                ),
              ),
            )
          },
          child: const Text("Make Payment"), // 显示按钮文本
        ),
      ),
    );
  }
}