Flutter支付插件esewa_pnp_forked的使用

Flutter支付插件esewa_pnp_forked的使用

esewa_pnp 是一个Flutter插件，让开发者能够仅通过几行代码将原生eSewa支付方法集成到他们的Flutter应用程序中。

如何安装

1. 依赖于它

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

   dependencies:
     esewa_pnp: ^2.0.1
   

2. [Android] 在你的 AndroidManifest.xml 文件中添加以下属性：

   <application
       ...
       android:theme="@style/Theme.AppCompat.Light.NoActionBar"
       ...>
       ...
   </application>
   

3. [iOS] esewa_pnp 版本^1.0.0在模拟器上无法测试。你需要依赖于插件GitHub仓库的 dev 分支。

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

   dependencies:
     # esewa_pnp: ^2.0.1 # 在生产应用或在真实物理iOS设备上测试esewa_pnp时使用。
     esewa_pnp:
       git:
         url: git://github.com/ayyshim/esewa_pnp.git
         ref: dev
   

使用

1. 创建一个 ESewaConfiguration 对象。开始时使用测试环境。当应用准备好后，你可以切换到正式环境（ENVIRONMENT_LIVE）。

   ESewaConfiguration _configuration = ESewaConfiguration(
       clientID: "<Client-ID>",
       secretKey: "<Secret-Key>",
       environment: ESewaConfiguration.ENVIRONMENT_TEST // ENVIRONMENT_LIVE
   );
   

   clientID 和 secretKey 值是由eSewa为每个商户/客户端提供的，并且是唯一的。在开发阶段，你可以使用以下凭证：

   clientID: "JB0BBQ4aD0UqIThFJwAKBgAXEUkEGQUBBAwdOgABHD4DChwUAB0R"
   secretKey: "BhwIWQQADhIYSxILExMcAgFXFhcOBwAKBgAXEQ=="
   

2. 创建 ESewaPnp 对象并传递配置。

   ESewaPnp _eSewaPnp = ESewaPnp(configuration: _configuration);
   

3. 最后创建支付对象。

   ESewaPayment _payment = ESewaPayment(
       amount: <ANY_DOUBLE_VALUE>,
       productName: "<Product-Name>",
       productID: "<Unique-Product-ID>",
       callBackURL: "<Call-Back-URL>"
   );
   

4. 调用 initPayment 方法。

   final _res = await _eSewaPnp.initPayment(payment: _payment);
   

5. 根据响应确定应用程序的行为。将 .initPayment 方法包裹在try-catch块中。

   try {
       final _res = await _eSewaPnp.initPayment(payment: _payment);
       // 处理成功
   } on ESewaPaymentException catch(e) {
       // 处理错误
   }
   

ESewaPaymentException

ESewaPaymentException 类在支付过程失败时被抛出。

• .message [String]：返回错误消息。

ESewaResult

ESewaResult 是在支付过程成功时返回的结果。

• .message [String]：返回可读的成功消息
• .productId [String]：返回客户支付的产品ID
• .productName [String]：返回客户支付的产品名称
• .totalAmount [String]：返回客户支付的总金额
• .date [String]：返回交易日期
• .status [String]：返回交易状态
• .referenceId [String]：返回交易参考ID

ESewaPaymentButton

ESewaPaymentButton 是一个可定制的按钮小部件。它接受 ESewaPnp，6个必需参数和8个可选参数。

要使用此按钮，你必须下载资源并将其粘贴到项目的 assets 文件夹中。在 pubspec.yaml 文件中也添加以下行。

flutter:
  assets:
    - assets/esewa/

示例 #1（默认）

ESewaPaymentButton(
  _esewaPnp,
  amount: 800.0,
  callBackURL: "https://example.com",
  productId: "abc123",
  productName: "ESewa Pnp Example",
  onSuccess: (ESewaResult result) {
    // 处理结果
  },
  onFailure: (ESewaPaymentException e) {
    // 处理错误
  },
),

示例 #2（白色背景）

更改按钮颜色也会动态更改标签颜色和eSewa徽标变体（深色/浅色）。

ESewaPaymentButton(
  _esewaPnp,
  amount: 800.0,
  callBackURL: "https://example.com",
  productId: "abc123",
  productName: "ESewa Pnp Example",
  onSuccess: (ESewaResult result) {
    // 处理结果
  },
  onFailure: (ESewaPaymentException e) {
    // 处理错误
  },
  color: Color(0xFFFFFFF), // 白色背景
),

示例 #3（带labelBuilder）

ESewaPaymentButton(
  _esewaPnp,
  amount: 800.0,
  callBackURL: "https://example.com",
  productId: "abc123",
  productName: "ESewa Pnp Example",
  onSuccess: (ESewaResult result) {
    // 处理结果
  },
  onFailure: (ESewaPaymentException e) {
    // 处理错误
  },
  color: Color(0xFF60BB47), // 绿色背景
  labelBuilder: (int amount, Widget esewaLogo) {
    return Text("Pay Rs.$amount");
  }
),