Flutter支付集成插件payable_ipg的使用

PAYable IPG - Flutter Integration

Flutter Package - ipg.flutter.payable.lk | Create Issue

初始化

1. 修改 minSdkVersion

在您的应用级 build.gradle 文件中将 minSdkVersion 修改为以下内容：

android {
    defaultConfig {
        minSdkVersion 20
    }
}

2. 在 pubspec.yaml 中添加依赖包

在项目的 pubspec.yaml 文件中添加以下内容：

payable_ipg: ^1.1.1

然后运行 flutter pub get 来安装依赖。

使用

1. 导入 PAYable IPG SDK 包

在 Dart 文件中导入 payable_ipg 包：

import 'package:payable_ipg/payable_ipg.dart';

2. 创建 PAYable IPG 客户端

创建一个 PAYableIPGClient 实例，并传入商户密钥、商户令牌、回调 URL 等信息：

PAYableIPGClient ipgClient = PAYableIPGClient(
  merchantKey: "YOUR_MERCHANT_KEY", // 商户密钥
  merchantToken: "YOUR_MERCHANT_TOKEN", // 商户令牌
  refererUrl: "YOUR_REQUEST_URL", // 回调 URL
  logoUrl: "YOUR_COMPANY_LOGO", // 公司 LOGO URL
  environment: IPGEnvironment.sandbox, // 可选：沙盒环境
);

3. 调用 PAYable IPG

在应用中使用 PAYableIPG 组件完成支付操作：

PAYableIPG(
  ipgClient: ipgClient, // 之前创建的客户端实例
  amount: 100.45, // 支付金额
  currencyCode: "LKR", // 币种
  orderDescription: "Netflix", // 订单描述
  customerFirstName: "Aslam", // 用户名
  customerLastName: "Kasun",
  customerEmail: "test@org.lk",
  customerMobilePhone: "0777123456",
  billingAddressStreet: "Hill Street", // 账单地址
  billingAddressCity: "Dehiwala",
  billingAddressCountry: "LK",
  billingAddressPostcodeZip: "10350",
  onPaymentCompleted: (data) { // 支付成功回调
    print("onPaymentCompleted: $data");
  },
  onPaymentCancelled: () { // 支付取消回调
    print("onPaymentCancelled");
  },
  onPaymentError: (data) { // 支付错误回调
    print("onPaymentError: $data");
  },
)

注意：配送信息和通知 URL 是可选的。

示例代码

以下是完整的示例代码：

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

void main() {
  // 初始化 PAYable IPG 客户端
  PAYableIPGClient ipgClient = PAYableIPGClient(
    merchantKey: "A75BCD8EF30E529A", // 替换为实际的商户密钥
    merchantToken: "B8727C74D29E210F9A297B65690C0140", // 替换为实际的商户令牌
    refererUrl: "https://www.sandboxmerdev.payable.lk", // 替换为实际的回调 URL
    logoUrl: "https://i.imgur.com/l21F5us.png", // 替换为实际的公司 LOGO URL
    environment: IPGEnvironment.sandbox, // 沙盒环境
  );

  // 创建 PAYable IPG 组件
  PAYableIPG payableIPG = PAYableIPG(
    ipgClient: ipgClient,
    amount: 100.45, // 支付金额
    currencyCode: "LKR", // 币种
    orderDescription: "Netflix", // 订单描述
    customerFirstName: "Aslam", // 用户名
    customerLastName: "Kasun",
    customerEmail: "test@org.lk",
    customerMobilePhone: "0777123456",
    billingAddressStreet: "Hill Street", // 账单地址
    billingAddressCity: "Dehiwala",
    billingAddressCountry: "LK",
    billingAddressPostcodeZip: "10350",
    onPaymentCompleted: (data) { // 支付成功回调
      print("onPaymentCompleted: $data");
    },
    onPaymentCancelled: () { // 支付取消回调
      print("onPaymentCancelled");
    },
    onPaymentError: (data) { // 支付错误回调
      print("onPaymentError: $data");
    },
  );

  // 启动应用
  runApp(
    MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text("PAYable IPG Demo"), // 应用标题
        ),
        body: payableIPG, // PAYable IPG 组件
      ),
    ),
  );
}

高级用法

1. 使用会话 ID (uid) 进行支付

如果已知会话 ID (uid)，可以直接通过 PAYableIPGSession 进行支付：

PAYableIPGSession payableIPGSession = PAYableIPGSession(
  uid: "9727F698-C1CE-4E22-96C6-9635EE600BA3", // 会话 ID
  onPaymentCompleted: (data) { // 支付成功回调
    print("onPaymentCompleted: $data");
  },
  onPaymentCancelled: () { // 支付取消回调
    print("onPaymentCancelled");
  },
  onPaymentError: (data) { // 支付错误回调
    print("onPaymentError: $data");
  },
  environment: IPGEnvironment.sandbox, // 环境设置
);

2. 查询交易状态

可以使用 getStatus 方法查询交易状态：

var data = await ipgClient.getStatus("uid", "resultIndicator");
print(data); // 打印返回结果