Flutter支付集成插件xendit_flutter的使用

Flutter支付集成插件xendit_flutter的使用

Xendit Flutter 是一个专门为 Flutter 应用程序集成 Xendit 支付网关而设计的包。通过 Xendit Flutter，开发者可以轻松创建各种支付方式（包括卡支付）的支付令牌，并简化其 Flutter 应用程序中的支付流程。

它还提供了与原生 Java（适用于 Android）和 SwiftUI（适用于 iOS）实现的无缝集成，使开发者能够在现有的原生移动应用程序中利用 Xendit 支付网关的强大功能。

安装与配置

Android

要让此插件在 Android 上运行，需要执行以下步骤：

1. 确保在你的 android/app/build.gradle 文件中设置 compileSdkVersion 为 34 并将 minSdkVersion 设置为 21：

android {
  compileSdkVersion 34
  ...
}
defaultConfig {
  minSdkVersion 21
  ...
}

1. 在你的 AndroidManifest.xml 文件中添加以下代码：

<manifest
    ...
    xmlns:tools="http://schemas.android.com/tools">
    <application
        ...
        tools:replace="android:label">
        ...
    </application>
    ...
</manifest>

iOS

iOS 只支持版本 11 及以上，因为这是原生 SDK Swift 的默认设置。

使用方法

Xendit Flutter 提供了两种类型的卡令牌认证：单次使用的令牌（createSingleToken）和多次使用的令牌（createMultipleUseToken）。你还可以对未验证的令牌进行认证，使用 createAuthentication 方法。此外，还提供了一些验证器，例如卡号验证器、CVN 验证器等。示例如下：

final XCard card = XCard(
  creditCardNumber: "4000000000001091",
  creditCardCVN: "123",
  expirationMonth: "12",
  expirationYear: "2024",
);

final Xendit xendit = Xendit('your-publish-key');
TokenResult result = await xendit.createSingleUseToken(card, amount: 50000, currency: "IDR");

if (result.isSuccess) {
  // 处理成功的情况
} else {
  debugPrint(result.errorMessage);
}

验证示例：

final bool numberValidator = CardValidator.isCardNumberValid("4000000000001091");

final bool expiryValidator = CardValidator.isExpiryValid("12", "2024");

final bool cvnValidator = CardValidator.isCvnValid("123");

示例代码

以下是示例代码的完整实现：

import 'package:flutter/material.dart';
import 'package:xendit_flutter_example/page/create_autentication_token.dart';
import 'package:xendit_flutter_example/page/create_token.dart';
import 'package:xendit_flutter_example/page/validate_util.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> {
  [@override](/user/override)
  void initState() {
    super.initState();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: HomePage(),
    );
  }
}

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('插件示例应用'),
      ),
      body: Column(
        crossAxisAlignment: CrossAxisAlignment.center,
        mainAxisAlignment: MainAxisAlignment.center,
        mainAxisSize: MainAxisSize.max,
        children: [
          const SizedBox(
            width: double.infinity,
          ),
          TextButton(
            onPressed: () => Navigator.push(
              context,
              MaterialPageRoute(
                builder: (context) => const CreateTokenPage(),
              )),
            child: const Text('创建令牌'),
          ),
          TextButton(
            onPressed: () => Navigator.push(
              context,
              MaterialPageRoute(
                builder: (context) => CreateAuthPage(),
              )),
            child: const Text('创建认证令牌'),
          ),
          TextButton(
            onPressed: () => Navigator.push(
              context,
              MaterialPageRoute(
                builder: (context) => ValidateUtilPage(),
              )),
            child: const Text('验证工具'),
          ),
        ],
      ),
    );
  }
}