Flutter支付集成插件tiptoppay_sdk的使用

支持的功能

• ✅ 检查卡号的有效性。
• ✅ 生成卡加密数据包。
• ✅ 显示3DS对话框。

开始使用

初始化Android环境

如果要在Android上显示3DS对话框，确保MainActivity实现FlutterFragmentActivity而不是FlutterActivity。

import io.flutter.embedding.android.FlutterFragmentActivity

class MainActivity: FlutterFragmentActivity() {}

使用方法

检查卡号有效性

bool isValid = await TipTopPaySdk.isValidNumber(cardNumber);

检查卡有效期

bool isValid = await TipTopPaySdk.isValidExpireDate(cardNumber); // MM/yy

生成卡加密数据包

你需要从个人账户获取publicId，并且需要提供apiUrl（例如：https://api.tiptoppay.kz/）。

final cryptogram = await TipTopPaySdk.createHexPacketFromData(
  event.cardNumber,
  event.expiryDate,
  event.cvcCode,
  Constants.MERCHANT_PUBLIC_ID,
  Constants.API_URL 
);

显示3DS表单并获取3DS验证结果

final result = await TipTopPaySdk.show3ds(
  acsUrl,
  transactionId,
  paReq,
);

Apple Pay

创建TipTopPayApplePay实例

final applePay = TipTopPayApplePay();

检查Apple Pay是否可用

final isApplePayAvailable = await applePay.isApplePayAvailable();

请求支付

final paymentToken = await applePay.requestApplePayPayment(
    merchantId: 'merchant.com.YOURDOMAIN',
    currencyCode: 'KZT',
    countryCode: 'KAZ',
    products: [
        {"name": "Red apple", "price": "170"},
        {"name": "Mango", "price": "250.50"},
        {"name": "Delivery", "price": "100"},
        {"name": "Discount", "price": "-89.90"},
        {"name": "Total", "price": "430.60"},
    ],
);

现在你可以使用paymentToken通过加密数据进行支付。

Google Pay

创建TipTopPayGooglePay实例

在构造函数中传入Google Pay环境（测试或生产）。

final googlePay = TipTopPayGooglePay(GooglePayEnvironment.production);

检查Google Pay是否可用

final isGooglePayAvailable = await googlePay.isGooglePayAvailable();

请求支付

final result = await googlePay.requestGooglePayPayment(
    price: '123.45',
    currencyCode: 'KZT',
    countryCode: 'KAZ',
    merchantName: 'Example Merchant',
    publicId: 'test_api_00000000000000000000002',
);

if (result != null) {
    if (result.isSuccess) {
      final paymentToken = result.token;
    }
}

现在你可以使用paymentToken通过加密数据进行支付。

示例代码

example/lib/main.dart

import 'package:tiptoppay_sdk_example/screens/checkout_screen.dart';
import 'package:flutter/material.dart';

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

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

class _MyAppState extends State<MyApp> {
  [@override](/user/override)
  void initState() {
    super.initState();
  }

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

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