Flutter支付功能插件flutter_pay的使用

Google Pay 准备工作

请参考 Android 官方文档进行配置。

Apple Pay 准备工作

请参考 Apple 官方文档进行配置。

使用方法

首先，你需要确保设备上支持 Pay API：

import 'package:flutter_pay/flutter_pay.dart';

FlutterPay flutterPay = FlutterPay();

// 检查设备是否支持支付
bool isAvailable = await flutterPay.canMakePayments();

如果你需要检查用户是否有至少一张有效的卡片：

import 'package:flutter_pay/flutter_pay.dart';

FlutterPay flutterPay = FlutterPay();

// 检查是否有有效卡片
bool isAvailable = await flutterPay.canMakePaymentsWithActiveCard();

// 你也可以指定允许的支付网络
bool isAvailable = await flutterPay.canMakePaymentsWithActiveCard(
  allowedPaymentNetworks: [
    PaymentNetwork.visa, 
    PaymentNetwork.masterCard,
  ],
);

要发起支付请求，可以使用 requestPayment 方法。此函数将返回一个 token，你需要将该 token 发送到你的网关以完成支付。示例如下：

import 'package:flutter_pay/flutter_pay.dart';

PaymentItem item = PaymentItem(name: "T-Shirt", price: 2.98);

FlutterPay flutterPay = FlutterPay();

// 设置环境为测试环境
flutterPay.setEnvironment(environment: PaymentEnvironment.Test);

String token = await flutterPay.requestPayment(
  googleParameters: GoogleParameters(
    gatewayName: "example",
    gatewayMerchantId: "example_id",
    merchantId: "example_merchant_id",
    merchantName: "exampleMerchantName",
  ),
  appleParameters: AppleParameters(merchantIdentifier: "merchant.flutterpay.example"),
  currencyCode: "USD",
  countryCode: "US",
  paymentItems: [item],
);

注意，某些参数仅影响 Apple Pay 或 Google Pay。例如，paymentItems 仅影响 Apple Pay，而最后一项用于总计标签。merchantName 仅影响 Google Pay，并会显示给用户。gatewayName 也仅影响 Google Pay，请参阅 Google Pay 集成部分。

支付网络矩阵

路线图

• ✅ 基本实现
• ❌ 完整文档
• ❌ 添加商户能力支持
• ❌ 添加账单和收货信息支持

完整示例 Demo

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

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

void main() => runApp(MyApp());

class MyApp extends StatefulWidget {
  [@override](/user/override)
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  FlutterPay flutterPay = FlutterPay();

  String result = "Result will be shown here";

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

  void makePayment() async {
    List<PaymentItem> items = [
      PaymentItem(name: "T-Shirt", price: 2.98)
    ];

    // 设置环境为测试环境
    flutterPay.setEnvironment(environment: PaymentEnvironment.Test);

    try {
      String token = await flutterPay.requestPayment(
        googleParameters: GoogleParameters(
          gatewayName: "example",
          gatewayMerchantId: "example_id",
        ),
        appleParameters: AppleParameters(merchantIdentifier: "merchant.flutterpay.example"),
        currencyCode: "USD",
        countryCode: "US",
        paymentItems: items,
      );

      setState(() {
        this.result = "Payment successful! Token: $token";
      });
    } catch (e) {
      setState(() {
        this.result = "Error: $e";
      });
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Plugin example app'),
        ),
        body: Container(
          padding: EdgeInsets.all(12.0),
          child: Column(
            mainAxisAlignment: MainAxisAlignment.spaceBetween,
            children: [
              Text(
                this.result,
                style: TextStyle(
                  fontSize: 16.0,
                ),
              ),
              ElevatedButton(
                child: Text("Can make payments?"),
                onPressed: () async {
                  try {
                    bool canMakePayments = await flutterPay.canMakePayments();
                    setState(() {
                      this.result = "Can make payments: $canMakePayments";
                    });
                  } catch (e) {
                    setState(() {
                      this.result = "Error: $e";
                    });
                  }
                },
              ),
              ElevatedButton(
                child: Text("Can make payments with verified card?"),
                onPressed: () async {
                  try {
                    bool canMakePaymentsWithActiveCard =
                        await flutterPay.canMakePaymentsWithActiveCard(
                      allowedPaymentNetworks: [
                        PaymentNetwork.visa,
                        PaymentNetwork.masterCard,
                      ],
                    );
                    setState(() {
                      this.result = "Can make payments with verified card: $canMakePaymentsWithActiveCard";
                    });
                  } catch (e) {
                    setState(() {
                      this.result = "Error: $e";
                    });
                  }
                },
              ),
              ElevatedButton(
                child: Text("Try to pay?"),
                onPressed: () {
                  makePayment();
                },
              )
            ],
          ),
        ),
      ),
    );
  }
}