Flutter支付处理插件square_pos的使用

一个用于Flutter的Square POS SDK包装器。

通过此插件，您的应用程序可以轻松地通过Android和iOS上的Square POS应用请求付款。

前置条件

1. 通过Square注册一个Square开发者帐户。
2. 设置iOS的部署目标为12.0或更高版本。
3. 设置Android的minSdkVersion为21或更高版本。

添加URL方案（iOS）

1. 将LSApplicationQueriesSchemes键添加到您的Info.plist文件中，以表明您的应用程序使用square-commerce-v1 URL方案来打开Square点餐服务。

<key>LSApplicationQueriesSchemes</key>
<array>
    <string>square-commerce-v1</string>
</array>

1. 在您的Info.plist文件中作为CFBundleURLTypes键添加自定义响应URL方案。

<key>CFBundleURLTypes</key>
<array>
  <dict>
    <key>CFBundleTypeRole</key>
    <string>Editor</string>
    <key>CFBundleURLName</key>
    <string>YOUR_BUNDLE_URL_NAME</string>
    <key>CFBundleURLSchemes</key>
    <array>
      <string>myapp-url-scheme</string>
    </array>
  </dict>
</array>

安装

在您的pubspec.yaml文件中添加square_pos依赖项：

dependencies:
  square_pos:

导入square_pos库：

import 'package:square_pos/square_pos.dart';

开始使用

初始化SquarePos SDK：

SquarePos.init(applicationID, callbackScheme);

检查Square POS是否已安装在设备上：

SquarePos.canRequest;

完成交易：

var request = SquarePosPaymentRequest(
    money: SquarePosMoney(amountCents: 100, currencyCode: "USD"),
    supportedTenderTypes: [
        SquarePosTenderType.card,
        SquarePosTenderType.cardOnFile,
        SquarePosTenderType.squareGiftCard
    ]);
SquarePos.requestPayment(request);

可用API

SquarePos.init(applicationID, callbackScheme);

SquarePos.canRequest;

SquarePos.requestPayment(request);

完整示例代码

以下是一个完整的示例代码，展示了如何使用square_pos插件进行支付处理。

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

import 'package:flutter/services.dart';
import 'package:square_pos/square_pos.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> {
  bool? _canRequest;
  String? _message;
  SquarePosPaymentResponse? _response;

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

  // 平台消息是异步的，所以我们在一个异步方法中初始化。
  Future<void> initSquarePOS() async {
    await SquarePos.init('test', 'test');

    bool? canRequest;
    String? message;
    // 平台消息可能会失败，所以我们使用try/catch处理PlatformException。
    // 我们还处理了可能返回null的消息。
    try {
      canRequest = await SquarePos.canRequest;
      message = (canRequest == true)
          ? 'Square POS已安装'
          : 'Square POS未安装';
    } on PlatformException {
      message = '未能检查Square POS是否已安装。';
    }

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

    setState(() {
      _canRequest = canRequest;
      _message = message;
    });
  }

  _requestPayment() async {
    var request = SquarePosPaymentRequest(
        money: SquarePosMoney(amountCents: 100, currencyCode: "USD"),
        supportedTenderTypes: [
          SquarePosTenderType.card,
          SquarePosTenderType.cardOnFile,
          SquarePosTenderType.squareGiftCard
        ]);
    var response = await SquarePos.requestPayment(request);

    setState(() {
      _response = response;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('插件示例应用'),
        ),
        body: Center(
            child: Column(children: [
          Text('可请求: $_canRequest\n'),
          Text('信息: $_message\n'),
          if (_canRequest ?? false)
            TextButton(
                onPressed: () => _requestPayment(),
                child: Text('请求: $1.00')),
          if (_response != null) Text('响应: $_response\n'),
        ])),
      ),
    );
  }
}