Flutter支付集成插件sumup_sdk_wrapper的使用

sumup_sdk_wrapper

目前此项目不再维护，因为原始项目已更新。请改用sumup。

Flutter包装器，用于使用最新的SumUp SDK。基于sumup。

连接到SumUp终端，登录并在Android上接受卡支付。

前提条件

1. 通过SumUp的国家网站注册商户账户（或收到测试账户）。
2. 收到SumUp卡终端：Air、Air Lite、PIN+终端、Chip & Signature读卡器、SumUp Air Register、Solo或Solo Lite（Solo和Solo Lite当前处于测试阶段）。
3. 通过SumUp开发者仪表板请求访问密钥并注册您的应用ID。
4. Android最低SDK版本为23或更高。

安装

在pubspec.yaml文件中添加sumup_sdk_wrapper：

dependencies:
  sumup_sdk_wrapper:

导入sumup：

import 'package:sumup_sdk_wrapper/sumup_sdk_wrapper.dart';

开始使用

初始化SumUp SDK

SumupSdkWrapper.init(affiliateKey);

登录

SumupSdkWrapper.login();

或者使用令牌登录：

SumupSdkWrapper.loginWithToken(token);

打开设置页面

SumupSdkWrapper.openSettings();

准备终端进行结账

SumupSdkWrapper.prepareForCheckout();

完成交易

var payment = SumupPayment(
    title: 'Test payment', // 支付标题
    total: 1.2,            // 总金额
    currency: 'EUR',       // 货币类型
    foreignTransactionID: '', // 外部交易ID
    saleItemsCount: 0,     // 销售项目数量
    skipSuccessScreen: false, // 是否跳过成功屏幕
    tip: .0,               // 小费
);

var request = SumupPaymentRequest(payment);

SumupSdkWrapper.checkout(request);

可用API

SumupSdkWrapper.init(affiliateKey); // 初始化SDK

SumupSdkWrapper.login(); // 登录

SumupSdkWrapper.isLoggedIn; // 检查是否已登录

SumupSdkWrapper.merchant; // 获取商户信息

SumupSdkWrapper.openSettings(); // 打开设置页面

SumupSdkWrapper.prepareForCheckout(); // 准备终端进行结账

SumupSdkWrapper.checkout(request); // 完成交易

SumupSdkWrapper.logout(); // 登出

// iOS独有
SumupSdkWrapper.isCheckoutInProgress; // 检查是否正在进行结账

示例代码

以下是一个完整的示例代码，展示如何使用sumup_sdk_wrapper完成支付流程。

示例代码：main.dart

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

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

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

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

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

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

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

  // 平台消息异步初始化
  Future<void> initPlatformState() async {
    String platformVersion;
    try {
      platformVersion =
          await _sumupSdkWrapperPlugin.getPlatformVersion() ?? 'Unknown platform version';
    } on PlatformException {
      platformVersion = 'Failed to get platform version.';
    }

    if (!mounted) return;

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('SumUp支付插件示例'),
        ),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
            Text('运行环境: $_platformVersion\n'),
            ElevatedButton(
              onPressed: () {
                // 初始化SDK
                SumupSdkWrapper.init('your_affiliate_key');

                // 登录
                SumupSdkWrapper.login();

                // 准备终端
                SumupSdkWrapper.prepareForCheckout();

                // 创建支付请求
                var payment = SumupPayment(
                  title: '测试支付',
                  total: 1.2,
                  currency: 'EUR',
                  foreignTransactionID: '',
                  saleItemsCount: 0,
                  skipSuccessScreen: false,
                  tip: 0.0,
                );

                var request = SumupPaymentRequest(payment);

                // 开始支付
                SumupSdkWrapper.checkout(request);
              },
              child: Text('开始支付'),
            ),
          ],
        ),
      ),
    );
  }
}