Flutter 接入支付宝支付全流程实战教程（iOS + Android）_flutter 支付宝支付开发流程-CSDN博客

本文链接：https://blog.csdn.net/Brad_chao/article/details/147852483

支付宝作为中国主流的移动支付方式之一，在许多 App 中都是标配接口。对于使用 Flutter 跨平台开发的应用来说，如何优雅地集成支付宝 SDK 是一项十分关键的任务。

本文将详细介绍如何在 Flutter 项目中实现 支付宝支付功能的集成与调用，支持 Android 和 iOS 双端，适合商城类、会员系统、订单系统等场景。

一、实现思路与注意事项

支付宝支付采用 跳转 App 支付 + 回调结果处理 的方式，核心逻辑如下：

Flutter 侧调用原生渠道方法，传入签名后的订单参数；
原生 SDK 调起支付宝 App 完成支付流程；
支付宝 App 回调支付结果，原生传回 Flutter 层；
Flutter 层根据结果做 UI 提示、业务逻辑处理等。

⚠️ 注意：支付宝支付 必须在服务端签名，客户端只负责调用 SDK，不要在客户端生成签名。

二、准备工作

1. 支付宝开放平台配置

登录支付宝开放平台；
创建应用，选择移动应用，填写基础信息；
获取以下信息：
- APP ID
- 应用公钥（开发者生成）
- 支付宝公钥（支付宝提供）
在服务端实现签名逻辑（建议后端使用 Java、PHP、Python等 SDK 生成签名）。

三、Flutter 插件选型

目前社区推荐的支付宝支付插件是：

✅ `flutter_alipay`（第三方插件）

dependencies:
  flutter_alipay: ^2.0.1  # 注意版本可根据 pub.dev 最新调整

四、iOS 配置步骤

1. 修改 `ios/Runner/Info.plist`

<key>LSApplicationQueriesSchemes</key>
<array>
  <string>alipay</string>
</array>

<key>CFBundleURLTypes</key>
<array>
  <dict>
    <key>CFBundleURLSchemes</key>
    <array>
      <string>你的URL Scheme（建议用你的APP_ID）</string>
    </array>
  </dict>
</array>

2. 配置 URL Scheme

支付宝在跳转后需要能返回原 App，请确保 URL Types 正确配置，CFBundleURLSchemes 中添加你注册的 Scheme。

3. Podfile 添加依赖

platform :ios, '11.0'

target 'Runner' do
  use_frameworks!
  pod 'AlipaySDK-iOS', '~> 15.8.09'
end

然后运行：

cd ios
pod install

五、Android 配置步骤

1. 修改 `AndroidManifest.xml`

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

<!-- 支付宝跳转所需 Scheme -->
<intent-filter>
  <action android:name="android.intent.action.VIEW"/>
  <category android:name="android.intent.category.DEFAULT"/>
  <category android:name="android.intent.category.BROWSABLE"/>
  <data android:scheme="你的URL Scheme（建议用你的APP_ID）"/>
</intent-filter>

2. 添加 SDK

支付宝 SDK 依赖会通过插件自动引入，也可以手动在 app/build.gradle 中添加：

implementation 'com.alipay.sdk:alipaysdk-android:15.8.09'

六、Flutter 调用代码示例

import 'package:flutter_alipay/flutter_alipay.dart';

Future<void> startAliPay(String orderString) async {
  try {
    AlipayResult result = await FlutterAlipay.pay(orderString);
    if (result.resultStatus == "9000") {
      // 支付成功
      print("支付成功");
    } else {
      // 支付失败或取消
      print("支付失败：${result.memo}");
    }
  } catch (e) {
    print("调用支付异常: $e");
  }
}

示例调用：

ElevatedButton(
  onPressed: () async {
    // 从后端获取签名后的 orderString
    String orderString = await fetchOrderStringFromServer();
    await startAliPay(orderString);
  },
  child: Text("发起支付宝支付"),
)

七、后端签名说明（简要）

支付宝的 orderString 是一个拼接好的参数字符串，由后端生成签名后返回。示例结构如下：

app_id=xxxxx&biz_content=...&sign=xxxx&sign_type=RSA2&...

后端可使用支付宝 SDK 提供的签名工具，确保私钥安全，避免客户端生成。

八、常见问题排查

问题	原因及解决方案
跳转失败，支付未响应	URL Scheme 配置错误，请确认 Info.plist / AndroidManifest
支付成功但未返回结果	检查原生平台的回调是否正确传回 Flutter
resultStatus 为 6001（用户取消）	用户手动取消，非异常
只在 Android 有效，iOS 无效	检查 iOS 是否配置 URL Schemes 并添加了支付宝白名单