Flutter集成Bank Alfalah支付网关：成功响应仍抛出异常

一、"success": true仍触发异常的原因及修复 #

你的代码在try块执行完毕后，无论请求是否成功，都会执行最后的throw Exception();语句，这是导致即使收到成功响应仍抛出异常的核心原因。

修复步骤： #

1. 删除代码末尾多余的throw Exception();
2. 在response.statusCode == 200的分支里，根据jsonResponse['success']的状态处理逻辑，正确返回数据或抛出异常：

if (response.statusCode == 200) {
  if (jsonResponse['success'] == true) {
    // 成功时返回AuthToken等数据
    return {
      "authToken": jsonResponse["AuthToken"],
    };
  } else {
    // 业务逻辑失败时抛出异常
    throw Exception("Payment initiation failed: ${jsonResponse['ErrorMessage']}");
  }
} else {
  // HTTP状态码非200时抛出异常
  throw Exception("Payment initiation failed: ${jsonResponse['ErrorMessage'] ?? 'Unknown HTTP error'}");
}

二、HMAC SHA-256哈希不匹配的排查方向 #

哈希不匹配会导致网关验证失败，进而引发异常，你可以从以下几点排查：

1. 签名参数与请求参数完全一致 #

生成签名的dataString必须和POST请求body中的参数完全对应，包括参数名、参数值、参数顺序，不能出现“签名用变量值、请求用硬编码值”的情况。

比如你测试时用硬编码的请求参数，那么dataString也需要同步改为硬编码：

var dataString = "HS_ChannelId=My channel Id&HS_IsRedirectionRequest=0"
    "&HS_MerchantId=My Merchant Id&HS_StoreId=My Store Id"
    "&HS_ReturnURL=xyz&HS_MerchantUsername=my username"
    "&HS_MerchantPassword=my pass&HS_TransactionReferenceNumber=12345";

2. 检查必填参数是否遗漏 #

注意你当前测试的body中没有传递HS_IsRedirectionRequest字段，但dataString里包含了这个参数，这会导致签名与实际请求参数不匹配，网关验证失败。需要确保body里包含所有签名时用到的参数。

3. 验证密钥与加密逻辑 #

• 确认key1是Bank Alfalah提供的原始密钥，没有被额外转义、添加空格或换行
• 测试加密逻辑：用网关提供的测试参数和静态哈希值反向验证，比如用已知的参数和正确哈希，检查你的_encryptData方法是否能生成一致的结果

4. 特殊字符处理 #

如果参数值包含特殊字符（比如returnUrl里的&、=），需要按照网关要求进行URL编码，确保签名和请求中的参数值编码方式一致。

三、额外建议 #

• 开启详细日志：打印生成的dataString、encryptedRequestHash以及完整的请求body，对比网关文档确认是否符合要求
• 联系网关技术支持：如果哈希问题仍无法解决，可以提供你的测试参数和生成的哈希，让网关方协助验证是否符合他们的签名规则

内容的提问来源于stack exchange，提问作者Usama Qadeer