Flutter支付集成插件fiatpe_payments_sdk的使用

fiatpe_payments_sdk

fiatpe_payments_sdk 是一个用于简化 Flutter 应用中 UPI 支付功能集成的 SDK。它旨在通过灵活和可扩展的设计来优化支付流程，并计划在未来支持更多支付选项。

✨ 特性

• 🔄 UPI Payments: 轻松将 UPI 支付集成到您的 Flutter 应用程序中。
• 🚀 未来就绪: 计划支持网银支付和信用卡/借记卡支付等更多支付方式。

🛠 安装

在 pubspec.yaml 文件中添加以下依赖：

dependencies:
  fiatpe_payments_sdk: ^1.0.1

或者通过运行以下命令直接添加依赖：

dart pub add fiatpe_payments_sdk

然后执行以下命令以获取依赖项：

flutter pub get

🛠 Android 配置

Add Internet Permission

确保在 AndroidManifest.xml 文件中设置了互联网权限。这一步对于处理应用与 FiatPe 支付服务器之间的网络通信至关重要。

在 <manifest> 标签内添加以下行：

<uses-permission android:name="android.permission.INTERNET" />

🛠 iOS 配置

Update Info.plist

为了确保应用可以检查是否安装了特定的支付应用程序并引导用户完成支付过程，需要在 Info.plist 中配置 URL schemes。

在 Info.plist 中添加以下配置：

<key>LSApplicationQueriesSchemes</key>
<array>
    <string>BHIM</string>
    <string>bhim</string>
    <string>com.amazon.mobile.shopping</string>
    <string>gpay</string>
    <string>imobile</string>
    <string>paytm</string>
    <string>paytmmp</string>
    <string>payzapp</string>
    <string>phonepe</string>
</array>

📝 使用说明

1. 导入库

在 Dart 文件中添加以下导入语句：

import 'package:fiatpe_payments_sdk/fiatpe_payments_sdk.dart';

2. 初始化 SDK

在应用启动时初始化 SDK，需要提供 API Key 和 Salt Key。

FiatPePayments.init(
  keys: const FiatPeAuthKeys(
    api: "YOUR_API_KEY",  // 您的 FiatPe API 密钥
    salt: "YOUR_SALT_KEY", // 您的 FiatPe Salt 密钥
  ),
  onFailed: (msg) {
    print("Initialization failed: $msg");
  },
  onSuccess: (msg) {
    print("Initialization succeeded: $msg");
  },
);

参数说明：

• api: （必填）由 FiatPe 提供的 API 密钥。
• salt: （必填）由 FiatPe 提供的 Salt 密钥。
• onFailed: （可选）初始化失败时触发的回调函数，接收错误消息字符串。
• onSuccess: （可选）初始化成功时触发的回调函数，接收成功消息字符串。

3. 启动 UPI 支付

调用 startPayment 方法发起 UPI 支付，传入封装好的 PaymentParams 参数。

FiatPePayments.startPayment(
  context: context,
  params: PaymentParams(
    transactionId: "TRANSACTIONID", // 交易 ID
    amount: 100.0, // 支付金额
    customerName: "John Doe", // 客户全名
    customerEmail: "customer@example.com", // 客户邮箱
    phoneNumber: "+911234567890", // 客户电话号码
    callbackURL: "https://example.com/payment_callback", // 支付回调 URL
    udf1: "custom data 1", // 可选自定义字段
    udf2: "custom data 2", // 可选自定义字段
    udf3: "custom data 3", // 可选自定义字段
    udf4: "custom data 4", // 可选自定义字段
    udf5: "custom data 5", // 可选自定义字段
  ),
  onPaymentResult: (result) {
    switch (result) {
      case PaymentSuccess():
        print("Payment Successful. Transaction ID: ${result.details.transactionId}");
        break;
      case PaymentFailure():
        print("Payment Failed. Error: ${result.details?.transactionId}");
        break;
      case PaymentPending():
        print("Payment Pending. Transaction ID: ${result.details.transactionId}");
        break;
      case PaymentCancelled():
        print("Payment Cancelled.");
        break;
      case PaymentUnknown():
        print("Unknown Payment Status.");
        break;
    }
  },
);