Flutter支付集成插件flutter_tappay_sdk的使用

Flutter支付集成插件flutter_tappay_sdk的使用

本项目是一个用于台湾流行支付网关TapPay的Flutter SDK。

警告: 这不是由TapPay官方维护的SDK。由于TapPay没有为Flutter提供官方SDK，因此创建了此项目来封装TapPay的官方SDK。

特性

• DirectPay（获取支付卡的prime）
• Apple Pay（获取prime）
• Google Pay（获取prime）

开始使用

Android

1. 在你的项目的android文件夹中，找到AndroidManifest.xml，并在application标签内添加以下属性：

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools" 
    >
  ...
  <application
      android:label="flutter_tappay_sdk_example"
      android:name="${applicationName}"
      android:icon="@mipmap/ic_launcher"
      tools:replace="android:label" 
      ...>
  ...
</manifest>

1. （可选。如果你需要使用Google Pay，则需要执行此步骤。）在你的项目的android文件夹中，将MainActivity的父类从FlutterActivity更改为FlutterFragmentActivity：

import io.flutter.embedding.android.FlutterFragmentActivity

class MainActivity: FlutterFragmentActivity() {
    // ...
}

iOS

（如果你需要使用Apple Pay，则需要执行此步骤。）打开Xcode并打开你的项目的Runner.xcworkspace文件。在Signing & Capabilities选项卡中，添加Apple Pay功能。别忘了在能力中添加Apple Pay商户ID。

Dart/Flutter项目

在pubspec.yaml文件中添加以下内容：

dependencies:
  flutter_tappay_sdk: ^0.3.0

使用方法

DirectPay

import 'package:flutter_tappay_sdk/flutter_tappay_sdk.dart';

// ...

final tappay = FlutterTappaySdk();
tappay.init(
  appId: 'your app id',
  appKey: 'your app key',
  serverType: ServerType.sandbox, // 或者 ServerType.production
);

// ...

final result = await tappay.getCardPrime(
  cardNumber: '4242424242424242',
  dueMonth: '01',
  dueYear: '23',
  cvv: '123',
);

if (result?.success) {
  print(result?.prime);
} else {
  print(result?.message);
}

更多示例可以在示例文件夹中找到。

完整示例Demo

import 'dart:developer';

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

import 'package:flutter/services.dart';
import 'package:flutter_tappay_sdk/flutter_tappay_sdk.dart';
import 'package:flutter_tappay_sdk/tappay/cart_item.dart';

import 'constants.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> {
  final _tapPaySdk = FlutterTapPaySdk();

  String _tapPaySdkVersion = 'Unknown';
  bool _isTapPayReady = false;

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

  Future<void> initTapPay() async {
    String tapPaySdkVersion = 'Unknown';
    bool isTapPayReady = false;

    try {
      var initResult = await _tapPaySdk.initTapPay(
          appId: kTapPayAppId, appKey: kTapPayAppKey, isSandbox: true);
      log(initResult?.toJson() ?? 'no initResult');
      isTapPayReady = initResult?.success == true;

      if (isTapPayReady) {
        tapPaySdkVersion =
            await _tapPaySdk.tapPaySdkVersion ?? 'Unknown TapPay SDK version';
      }
    } on PlatformException {
      log('PlatformException');
    }

    if (!mounted) return;

    setState(() {
      _tapPaySdkVersion = tapPaySdkVersion;
      _isTapPayReady = isTapPayReady;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Flutter TapPay SDK Example'),
        ),
        body: ListView(
          children: [
            Text('TapPay SDK initial result: $_isTapPayReady'),

            // 显示TapPay SDK版本
            Text('TapPay SDK version: $_tapPaySdkVersion'),

            // 使用支付卡信息获取prime
            if (_isTapPayReady)
              ListTile(
                title: const Text('通过支付卡获取Prime'),
                onTap: () async {
                  try {
                    final prime = await _tapPaySdk.getCardPrime(
                      cardNumber: kDefaultTestingCardNumber,
                      dueMonth: kDefaultTestingDueMonth,
                      dueYear: kDefaultTestingDueYear,
                      cvv: kDefaultTestingCvv,
                    );
                    log('prime: ${prime?.toJson()}');
                  } on PlatformException {
                    log('PlatformException');
                  }
                },
              ),

            if (_isTapPayReady)
              ListTile(
                title: const Text('启动Google Pay'),
                onTap: () async {
                  try {
                    final isGooglePayReady = await _tapPaySdk.initGooglePay(
                        merchantName: 'Flutter Cafe');
                    log('isGooglePayReady: ${isGooglePayReady?.toJson()}');

                    if (isGooglePayReady?.success == true) {
                      var payResult =
                          await _tapPaySdk.requestGooglePay(price: 2);
                      log('payResult: ${payResult?.toJson()}');
                    }
                  } on PlatformException {
                    log('PlatformException');
                  }
                },
              ),

            if (_isTapPayReady)
              ListTile(
                title: const Text('启动Apple Pay'),
                onTap: () async {
                  try {
                    final isApplePayReady = await _tapPaySdk.initApplePay(
                        merchantId: kTapPayApplePayMerchantId,
                        merchantName: 'Flutter Cafe');
                    log('isApplePayReady: ${isApplePayReady?.toJson()}');

                    if (isApplePayReady?.success == true) {
                      var payResult = await _tapPaySdk.requestApplePay(
                        cartItems: [
                          CartItem(name: "Cupcake", price: 2),
                          CartItem(name: "Donut", price: 3),
                        ],
                      );
                      log('payResult: ${payResult?.toJson()}');

                      if (payResult?.success == true) {
                        var reportResult =
                            await _tapPaySdk.applePayResult(result: true);
                        log('reportResult: ${reportResult?.toJson()}');
                      }
                    }
                  } on PlatformException {
                    log('PlatformException');
                  }
                },
              ),
          ],
        ),
      ),
    );
  }
}