Flutter支付插件moamalat_payment的使用

Moamalat_Payment 是一个用于 Flutter 应用程序的插件，允许你集成 Moamalat 支付网关。它通过加载包含交易详情的 WebView 来实现这一点，并处理来自支付网关的响应。该类提供了回调函数来处理成功交易和错误情况。

功能

• 与 Moamalat 支付网关集成：MoamalatPayment 类让你能够轻松地将 Moamalat 支付网关集成到你的 Flutter 应用程序中。
• WebView 集成：该类提供了一个 WebView，用于加载 Moamalat 支付页面并处理交易详情。
• 交易处理：该类处理来自支付网关的响应，并通过回调函数处理成功交易和错误。
• 测试模式支持：MoamalatPayment 类可以在测试模式和生产模式下工作。
• 安全交易：该类生成 Moamalat 所需的安全哈希，以确保交易的安全性。
• 可定制：该类允许你配置诸如商户ID、商户引用、终端ID、金额和商户密钥等参数来处理支付。

总体而言，MoamalatPayment 类提供了一种方便且安全的方法来将 Moamalat 支付网关集成到你的 Flutter 应用程序中。

开始使用

MoamalatPayment 类是一个 Flutter 小部件，允许你将 Moamalat 支付网关集成到你的 Flutter 应用程序中。它通过加载包含交易详情的 WebView 来实现这一点，并处理来自支付网关的响应。

构造函数

MoamalatPayment 类有一个构造函数，接受以下参数：

• merchantId：从 Moamalat 获取的商户ID。
• merchantReference：交易的唯一参考编号。
• terminalId：从 Moamalat 获取的终端ID。
• amount：交易应收取的金额。
• merchantSecretKey：从 Moamalat 获取的密钥。
• onCompleteSucsses：当支付成功完成时调用的回调函数。此函数接受一个 TransactionSucsses 对象作为参数。
• onError：当支付过程中发生错误时调用的回调函数。此函数接受一个 PaymentError 对象作为参数。
• isTest：一个布尔值，指示支付应该在测试模式还是生产模式下进行。默认值为 false。

状态

MoamalatPayment 类有一个单状态类 _MoamalatPaymentState，继承自 State 类。它包含处理 WebView 和处理支付的逻辑。

方法

MoamalatPayment 类有两个私有方法：

1. checkTest()：根据是否在测试模式或生产模式下处理支付来设置 Moamalat 支付页面的 URL。
2. hex2a(String hex)：将十六进制字符串转换为 ASCII。

_MoamalatPaymentState 类有三个私有方法：

1. getDateTimeLocalTrxnStr()：获取当前日期和时间，格式符合 Moamalat 的要求。
2. encodeData()：将交易详情编码为符合 Moamalat 要求的格式。
3. hash()：生成 Moamalat 所需的安全哈希。

小部件

MoamalatPayment 类包含一个 InAppWebView 小部件，用于加载 Moamalat 支付页面。它还包含 InAppWebViewGroupOptions 类，提供 WebView 的选项。

回调

MoamalatPayment 类有两个回调函数：

1. onCompleteSucsses：当支付成功完成时调用。此回调函数接受一个 TransactionSucsses 对象作为参数。
2. onError：当支付过程中发生错误时调用。此回调函数接受一个 PaymentError 对象作为参数。

处理数据

错误处理

MoamalatPayment 类通过调用带有 PaymentError 对象（包含错误详情）的 onError 函数来处理错误。

响应处理

MoamalatPayment 类通过调用带有 TransactionSucsses 对象（包含已完成交易详情）的 onCompleteSucsses 函数来处理来自 Moamalat 的响应。

使用示例

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

class MoamalatPay extends StatefulWidget {
  const MoamalatPay({super.key});

  [@override](/user/override)
  State<MoamalatPay> createState() => _MoamalatPayState();
}

class _MoamalatPayState extends State<MoamalatPay> {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(),
      body: MoamalatPayment(
        isTest:
            true, // 测试 SDK 模式 - 如果你在生产环境中使用，请将其设置为 false
        merchantId: "10081014649", // 填写你的商户ID
        merchantReference: "PS_Merchant",
        terminalId: "99179395", // 填写你的终端ID
        amount:
            "1000", // 从之前的屏幕获取金额 注意：必须是整数，不能有任何逗号 *1000
        // 例如：如果你需要充值 10 第纳尔，金额将是 10 *1000
        // 例如：如果你需要充值 10.5 第纳尔，金额将是 10500
        merchantSecretKey:
            "39636630633731362D663963322D346362642D386531662D633963303432353936373431", // 填写你的商户密钥
        // * 确保所有值都是字符串 *
        onCompleteSucsses: (value) {},
        onError: (error) {},
      ),
    );
  }
}