Flutter支付处理插件midtrans的使用

midtrans是一个非官方插件，用于在Flutter应用中集成Midtrans移动SDK。该插件在Midtrans的snap模式下运行。您可以在此文档中阅读更多详细信息。

开始使用

要求

• 客户端密钥：从Midtrans商户账户获取。
• 商户服务器：需要后端实现，因为Midtrans移动SDK依赖于服务器端。您可以查看商户服务器实现参考，并根据您的后端需求逐步实现API。

完成上述要求后，您需要配置项目。

配置项目

修改 AndroidManifest.xml

将以下内容添加到 AndroidManifest.xml 文件中：

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.hello_example" xmlns:tools="http://schemas.android.com/tools">
   <application
        android:label="hello_example"
        android:icon="@mipmap/ic_launcher"
        tools:replace="android:label"
        android:theme="@style/AppTheme"
       >
        .....
    </application>
</manifest>

修改 styles.xml

在项目的 styles.xml 文件中进行如下修改（通常位于 android/app/src/main/res/values/styles.xml）：

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <!-- 启动时的主题 -->
    <style name="LaunchTheme" parent="@android:style/Theme.Light.NoTitleBar">
        <!-- 设置启动屏幕背景 -->
        <item name="android:windowBackground">@drawable/launch_background</item>
    </style>
    <!-- 应用主题 -->
    <style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar">
        <item name="windowActionBar">false</item>
        <item name="windowNoTitle">true</item>
    </style>
    <!-- 正常主题 -->
    <style name="NormalTheme" parent="@android:style/Theme.Light.NoTitleBar">
        <item name="android:windowBackground">?android:colorBackground</item>
    </style>
</resources>

排错

如果遇到任何问题，可以打开GitHub上的issue或联系作者。

错误调试

在调试模式下运行时出现错误

错误代码类似如下：

E/AndroidRuntime(28442): java.lang.AssertionError
E/AndroidRuntime(28442): 	at com.koushikdutta.async.AsyncSSLSocketWrapper.write(AsyncSSLSocketWrapper.java:390)
E/AndroidRuntime(28442): 	at com.koushikdutta.async.AsyncSSLSocketWrapper.handleHandshakeStatus(AsyncSSLSocketWrapper.java:276)
E/AndroidRuntime(28442): 	at com.koushikdutta.async.AsyncSSLSocketWrapper.handshake(AsyncSSLSocketWrapper.java:114)
...

此错误可能是由于Midtrans移动SDK使用的第三方库导致的。解决方法是在发布模式下运行，或者将Gradle版本降低到4.0.2或更低。

修改Gradle版本

在 android/build.gradle 文件中修改Gradle版本为4.0.2：

dependencies {
        classpath 'com.android.tools.build:gradle:4.0.2'
        .....
}

完整示例

以下是一个完整的示例代码，展示如何使用Flutter插件 midtranz 进行支付处理。

示例代码

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

import 'package:flutter/services.dart';
import 'package:midtranz/midtranz.dart'; // 导入midtranz插件

void main() {
  runApp(MyApp());
}

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

class _MyAppState extends State<MyApp> {
  final midtrans = Midtrans(); // 初始化Midtrans实例
  String _platformVersion = 'Unknown'; // 平台版本

  [@override](/user/override)
  void initState() {
    super.initState();
    midtrans.init(MidtransConfig( // 初始化Midtrans配置
        clientKey: 'YOUR_CLIENT_KEY', // 替换为您的客户端密钥
        merchantBaseUrl: 'https://YOUR_MERCHANT_URL_DOMAIN.com/', // 替换为您的商户URL
        colorTheme: MidtransColorTheme( // 自定义颜色主题
            lightPrimaryColor: Colors.deepOrange,
            darkPrimaryColor: Colors.deepOrange,
            secondaryColor: Colors.blueAccent)));
    midtrans.setTransactionFinishCallback((result) { // 设置交易完成回调
      print("Result ${result.status}"); // 打印交易结果状态
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Flutter Midtrans 示例'), // 设置应用标题
        ),
        body: Center(
          child: Text('运行环境: $_platformVersion\n'), // 显示平台版本
        ),
        floatingActionButton: FloatingActionButton(
          onPressed: () async { // 支付按钮点击事件
            await midtrans.payTransaction(MidtransTransaction( // 发起支付交易
              amount: 40000, // 支付金额
              skipCustomer: false, // 是否跳过客户信息
              midtransCustomer: MidtransCustomer( // 客户信息
                  customerIdentifier: "USER01", // 用户标识
                  phone: "089689008988", // 用户电话
                  lastName: "Hanif", // 用户姓氏
                  firstName: "Ibrahim", // 用户名字
                  email: 'email@mail.com', // 用户邮箱
                  billingAddress: MidtransCustomerAddress( // 账单地址
                      address: "Losari Kidul",
                      city: "Cirebon",
                      postalCode: "45192"),
                  shippingAddress: MidtransCustomerAddress( // 发货地址
                      address: "Losari Kidul",
                      city: "Cirebon",
                      postalCode: "45192")),
              items: [ // 商品列表
                MidtransItem(
                    id: '123456', price: 10000, quantity: 1, name: 'GoPayment') // 商品详情
              ],
            ));
          },
        ),
      ),
    );
  }
}