Flutter支付插件urwaypayment的使用

Urway是一个在Flutter中使用的支付网关。该Flutter插件为商家提供了与Urway支付网关API轻松无痛集成的功能。

开始使用

首先，在你的pubspec.yaml文件中导入该包：

dependencies:
  urwaypayment: ^2.0.5

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

系统需求

要使用此插件，你的系统需要满足以下条件：

• Flutter >= 3.5.1
• Dart >= 3.0.0 < 4.0.0
• iOS >= 12.0
• MacOS >= 10.14
• Android compileSdk 34
• Java 17
• Android Gradle Plugin 8.5.2
• Gradle Wrapper >= 8.4

额外配置

为了执行交易，你需要在应用的配置文件appconfig.json中配置终端ID、终端密码、商户密钥和URL。将该文件放置到应用的资产文件夹中。

权限设置

在Android和iOS平台上分别添加所需的权限：

Android

在AndroidManifest.xml文件中添加以下权限：

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.WAKE_LOCK" />

完整示例

下面是一个完整的示例代码，展示了如何使用urwaypayment插件进行支付。

import 'dart:async';

import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:urwaypayment/urwaypayment.dart';

void main() => runApp(MyApp());

class MyApp extends StatefulWidget {
  [@override](/user/override)
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  [@override](/user/override)
  void initState() {
    super.initState();
  }

  Future<void> makePayment() async {
    // 存储支付数据
    dynamic lastResult;

    try {
      // 发起支付请求
      lastResult = await Payment.makepaymentService(
        context: context,
        country: "SA",
        action: "1",
        currency: "SAR",
        amt: "1.00",
        customerEmail: "john.deo@gmail.com",
        trackid: "111AAA",
        udf1: "", // 用户自定义字段1
        udf2: "", // 用户自定义字段2
        udf3: "", // 用户自定义字段3
        udf4: "", // 用户自定义字段4
        udf5: "", // 用户自定义字段5
        cardToken: "", // 卡令牌
        address: "ABC", // 地址
        city: "PQR", // 城市
        state: "XYZ", // 州/省
        tokenizationType: "1", // 令牌化类型
        zipCode: "", // 邮政编码
        tokenOperation: "A/U/D", // 令牌操作
        metadata: "" // 元数据
      );

      print('支付结果: $lastResult');
    } on PlatformException {
      print('支付失败');
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('支付测试'),
        ),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: <Widget>[
              Text('等待响应...'),
              ElevatedButton(
                child: Text('调用支付'),
                onPressed: () => makePayment(),
              ),
              ElevatedButton(
                child: Text('调用Apple Pay支付'),
                onPressed: () => makePayment(),
              ),
            ],
          ),
        ),
      ),
    );
  }
}