Flutter支付功能插件uni_pay的使用

Flutter支付功能插件uni_pay的使用

支付网关库由UNICODE团队打造，用于无缝交易

uni_pay 是一个全面的库，用于无缝的在线支付，集成了 Moyasar（卡支付 & Apple Pay）、Tamara 和 Tabby 支付网关。它可以帮助你轻松处理交易，提升用户体验，并简化支付处理流程。

功能支持

• 卡支付支持 (mada, visa, mastercard, amex)
• Apple Pay 集成和 Xcode 设置
• Tamara 支持
• Tabby 支持

快速开始

你可以查看 /example 项目以更好地理解实现方式。

完整示例代码

以下是一个完整的示例代码，展示了如何在 Flutter 应用中使用 uni_pay 插件进行支付。

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

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

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

  @override
  Widget build(BuildContext context) {
    return const MaterialApp(
      debugShowCheckedModeBanner: false,
      title: 'UniPay Example',
      home: PaymentView(),
    );
  }
}

class PaymentView extends StatefulWidget {
  const PaymentView({Key? key}) : super(key: key);

  @override
  State<PaymentView> createState() => _PaymentViewState();
}

class _PaymentViewState extends State<PaymentView> {
  @override
  void initState() {
    super.initState();
    // 初始化 UniPay 可以通过调用此方法完成
    // UniPayServices.initUniPay(uniPayData: uniPayData, context: context);
  }

  @override
  Widget build(BuildContext context) {
    return UniPay(
      context: context,
      uniPayData: uniPayData,
    );
  }

  // 显示仅 Apple Pay 的视图
  Widget _applePayOnlyView() {
    return Scaffold(
      appBar: AppBar(title: const Text("UniPay Example")),
      body: ListView(
        padding: const EdgeInsets.all(16),
        children: [
          UniApplePay(context: context),
        ],
      ),
    );
  }
}

/// 用于支付请求的 UniPayData
UniPayData uniPayData = UniPayData(
  appName: "UniPay",
  locale: UniPayLocale.en, // 设置语言为英语
  customerInfo: UniPayCustomerInfo(
    fullName: "Mohammad Saif", // 客户全名
    email: "example@mail.com", // 客户邮箱
    phoneNumber: "+966555666777", // 客户电话号码
    address: UniPayAddress(
      addressName: "Olaya street, Al Ghadir", // 地址名称
      city: "Riyadh", // 城市
    ),
  ),
  environment: UniPayEnvironment.development, // 设置环境为开发环境
  credentials: UniPayCredentials(
    applePayMerchantIdentifier: "merchant.com.myapp.sa", // Apple Pay 商家标识符
    paymentMethods: [
      UniPayPaymentMethods.card, // 支持卡片支付
      UniPayPaymentMethods.applepay, // 支持 Apple Pay
      UniPayPaymentMethods.tamara, // 支持 Tamara
      UniPayPaymentMethods.tabby, // 支持 Tabby
    ],
    moyasarCredential: MoyasarCredential(
      publishableKey: "pk_test", // Moyasar 公钥
      secretKey: "sk_test", // Moyasar 私钥
    ),
    tamaraCredential: TamaraCredential(
      token: "Bearer test", // Tamara 认证令牌
      merchantUrl: MerchantUrl(notification: "https://my-app.com/webhook"), // 商家通知 URL
    ),
    tabbyCredential: TabbyCredential(
      psKey: "pk_test", // Tabby 公钥
      secretKey: "sk_test", // Tabby 私钥
      merchantCode: "your_merchant_code", // 商家代码
    ),
  ),
  orderInfo: UniPayOrder(
    transactionAmount: TransactionAmount(totalAmount: 150.55), // 总金额
    orderId: DateTime.now().millisecondsSinceEpoch.toString(), // 订单 ID
    description: "Test Order Description", // 订单描述
    items: [
      UniPayItem(
        id: "Product_ID", // 商品 ID
        name: "Product name", // 商品名称
        quantity: 1, // 商品数量
        price: 50, // 商品价格
      )
    ],
  ),
  onPaymentSucess: (res) {
    debugPrint("Payment Success ----> ${res.toMap()}"); // 支付成功回调
  },
  onPaymentFailed: (res) {
    debugPrint("Payment Failed ----> ${res.toMap()}"); // 支付失败回调
  },
  metaData: {
    "customerId": "ABC_12345", // 自定义元数据
    "customerName": "Mohammad Saif", // 自定义元数据
  },
);

Tabby 特性

• 获取交易详情：

  TabbyTransaction transaction = await UniTabbyServices.getTabbyTransactionDetails(
    tabbyDto: TabbyDto(
      transactionId: "trxn_id", // 交易 ID
      credential: TabbyCredential(
        psKey: "pk_test", // 公钥
        secretKey: "sk_test", // 私钥
        merchantCode: "your_merchant_code", // 商家代码
      ),
    ),
  );
  

• 捕获订单：

  TabbyTransaction transaction = await UniTabbyServices.captureTabbyPayment(
    tabbyDto: TabbyDto(
      transactionId: "trxn_id", // 交易 ID
      credential: TabbyCredential(
        psKey: "pk_test", // 公钥
        secretKey: "sk_test", // 私钥
        merchantCode: "your_merchant_code", // 商家代码
      ),
      amount: 950.55, // 捕获金额
    ),
  );
  

• 显示产品页面的 Tabby 标识：

  UniTabbyServices.showProductPageTabbySnippet(
    tabbySnippet: TabbySnippet(
      totalAmountWithVat: 150.50, // 含税总金额
      locale: UniPayLocale.ar, // 语言设置为阿拉伯语
    ),
  );
  

• 显示结账页面的 Tabby 标识：

  UniTabbyServices.showTabbyCheckoutSnippet(
    tabbySnippet: TabbySnippet(
      totalAmountWithVat: 150.50, // 含税总金额
      locale: UniPayLocale.ar, // 语言设置为阿拉伯语
    ),
  );
  

Tamara 特性

• 显示产品页面的 Tamara 标识：

  UniPayServices.tamaraProductPageSnippet(
    const TamaraSnippet(
      psKey: "ps_key", // 公钥
      transactionAmount: 150, // 交易金额
      locale: UniPayLocale.en, // 语言设置为英语
    ),
  );
  

• 显示结账页面的 Tamara 标识：

  UniPayServices.tamaraCheckoutPageSnippet(
    const TamaraSnippet(
      psKey: "ps_key", // 公钥
      transactionAmount: 150, // 交易金额
      locale: UniPayLocale.ar, // 语言设置为阿拉伯语
    ),
  );