.NET MAUI集成Payfast支付后无法回调至应用的技术求助

核心问题分析 #

Payfast仅支持HTTP/HTTPS格式的return_url，自定义URL Scheme（如myapp://）会被判定为无效；而API直接通过Redirect跳转自定义Scheme会被浏览器的安全策略拦截，导致无法唤起MAUI应用。

可行解决方案 #

1. 确保MAUI应用的自定义URL Scheme已正确配置 #

这是唤起应用的基础，必须先完成平台配置：

• Android：在Platforms/Android/AndroidManifest.xml中添加Intent Filter：

  <activity android:name=".MainActivity">
      <intent-filter>
          <action android:name="android.intent.action.VIEW" />
          <category android:name="android.intent.category.DEFAULT" />
          <category android:name="android.intent.category.BROWSABLE" />
          <!-- 替换为你的自定义Scheme -->
          <data android:scheme="myapp" />
      </intent-filter>
  </activity>
  

• iOS：在Platforms/iOS/Info.plist中添加URL Scheme配置：

  <key>CFBundleURLTypes</key>
  <array>
      <dict>
          <key>CFBundleURLSchemes</key>
          <array>
              <!-- 替换为你的自定义Scheme -->
              <string>myapp</string>
          </array>
      </dict>
  </array>
  

2. 改造API回调逻辑：返回HTML页面通过JS或用户交互跳转 #

不要直接用Redirect，而是返回一个包含跳转逻辑的HTML页面——浏览器对用户触发或延迟的自定义Scheme跳转限制更宽松：
在你的API接口中（以ASP.NET Core为例），返回如下HTML内容：

[HttpGet("payfast-return")]
public IActionResult PayfastReturn(string transactionId)
{
    // 先验证Payfast回调的签名（必须步骤，防止伪造）
    // 参考Payfast文档完成签名验证逻辑

    // 生成跳转HTML
    var html = $@"
<!DOCTYPE html>
<html>
<head>
    <meta charset='UTF-8'>
    <title>支付完成</title>
    <script>
        // 延迟1秒自动跳转，给浏览器足够的处理时间
        setTimeout(() => {{
            window.location.href = 'myapp://payment-complete?transactionId={transactionId}';
        }}, 1000);
    </script>
</head>
<body style='text-align:center; padding:50px; font-family:Arial;'>
    <h2>支付已完成</h2>
    <p>正在返回应用...</p>
    <p>如果未自动跳转，请点击 <a href='myapp://payment-complete?transactionId={transactionId}'>这里</a></p>
</body>
</html>";

    return Content(html, "text/html");
}

3. 在MAUI中处理自定义URL回调 #

在App.xaml.cs中重写OnAppLinkRequestReceived方法，处理跳转过来的支付结果：

protected override void OnAppLinkRequestReceived(Uri uri)
{
    if (uri.Scheme.Equals("myapp", StringComparison.OrdinalIgnoreCase) 
        && uri.Host.Equals("payment-complete", StringComparison.OrdinalIgnoreCase))
    {
        // 提取交易参数
        var queryParams = System.Web.HttpUtility.ParseQueryString(uri.Query);
        var transactionId = queryParams["transactionId"];

        // 在主线程更新UI或导航到结果页面
        MainThread.BeginInvokeOnMainThread(async () =>
        {
            await Shell.Current.GoToAsync($"//PaymentSuccessPage?transactionId={transactionId}");
        });
    }

    base.OnAppLinkRequestReceived(uri);
}

4. 补充：Payfast的Notify URL处理 #

不要依赖return_url作为唯一的交易状态通知渠道，必须配置notify_url到你的API，在该接口中完成交易状态的最终验证与更新——因为用户可能在支付完成后直接关闭浏览器，不会触发return_url跳转。

内容的提问来源于stack exchange，提问作者Etienne van Heerden