Flutter支付集成插件flutter_pay_orc的使用

flutter_pay_orc

一个用于orc支付的Flutter插件。

开发者：PayOrc

入门指南

关于SDK

遵循以下步骤：

步骤 1：在应用程序初始化时指定环境

在您的应用程序中，在初始化时指定环境。

void main() {        
    FlutterPayOrc.initialize(
        merchantKey: 'your-merchant-key', // 更新您的商户密钥。
        merchantSecret: 'your-merchant-secret', // 更新您的商户密钥。
        environment: Environment.test, // 切换到Environment.production以启用生产环境
    );
    runApp(const MyApp());
}

步骤 2：实现createPaymentWithWidget方法，该方法将在视图上自动推送

在应用程序中调用此方法：

await FlutterPayOrc.instance.createPaymentWithWidget(
    context: context,
    request: createPayOrcPaymentRequest(), // 创建支付请求对象
    onPopResult: (String? pOrderId) async {
        await _fetchTransaction(pOrderId); // 获取交易状态
    },
    errorResult: (message) {
        // 显示错误提示给用户
    });

示例代码：创建支付请求对象

PayOrcPaymentRequest(
    data: Data(
      className: PayOrcClass.ecom.name.toUpperCase(),
      action: PayOrcAction.sale.name.toUpperCase(),
      captureMethod: PayOrcCaptureMethod.manual.name.toUpperCase(),
      paymentToken: "",
      orderDetails: OrderDetails(
        mOrderId: "1234",
        amount: "500",
        convenienceFee: "0",
        quantity: "1",
        currency: "AED", // 应动态设置货币
        description: "",
      ),
      customerDetails: CustomerDetails(
        mCustomerId: "123",
        name: "John Doe",
        email: "johndoe@example.com",
        mobile: "987654321",
        code: "971", // 不应包含+号
      ),
      billingDetails: BillingDetails(
        addressLine1: "address 1",
        addressLine2: "address 2",
        city: "Amarpur",
        province: "Bihar", // 州
        country: "IN", // 应为两位国家代码
        pin: "482008",
      ),
      shippingDetails: ShippingDetails(
        shippingName: "John Doe",
        shippingEmail: "",
        shippingCode: "91", // 不应包含+号
        shippingMobile: "9876543210",
        addressLine1: "address 1",
        addressLine2: "address 2",
        city: "Mumbai",
        province: "Maharashtra", // 州
        country: "IN", // 应为两位国家代码
        pin: "482005",
        locationPin: "https://www.google.com/maps?q=24.227923067092433,80.07790793685352",
        shippingCurrency: "AED", // 应动态设置货币
        shippingAmount: "10",
      ),
      urls: Urls(
        success: "",
        cancel: "",
        failure: "",
      ),
      parameters: [
        {
          "alpha": "",
        },
        {
          "beta": "",
        },
        {
          "gamma": "",
        },
        {
          "delta": "",
        },
        {
          "epsilon": "",
        }
      ],
      customData: [
        {
          "alpha": "",
        },
        {
          "beta": "",
        },
        {
          "gamma": "",
        },
        {
          "delta": "",
        },
        {
          "epsilon": "",
        }
      ],
    ),
);

注意事项：

• 所有字段均为必填项。
• 如果某个字段没有数据，请将其作为空字符串发送，而不是传递null。
• 类、操作和捕获方法为枚举类型。
• 参数和自定义数据将是HashMap的列表。

步骤 3：获取支付交易状态

通过createPayment响应中的p_order_id获取支付交易状态。

在应用程序中调用此方法：

final transaction = await FlutterPayOrc.instance.fetchPaymentTransaction(
  orderId: pOrderId.toString(),
  onLoadingResult: (loading) {
      // 使用此布尔值管理加载状态
  },
  errorResult: (message) {
      // 显示错误提示给用户
  },
);
if (transaction != null) {
  // 将交易信息更新到商户服务器

  FlutterPayOrc.instance.clearData();
}

步骤 4：清除本地数据

调用以下方法清除本地数据。

在应用程序中调用此方法：

FlutterPayOrc.instance.clearData();