Android调用UPI支付始终失败，同参数直接操作正常，求原因

看起来你遇到了UPI支付集成的典型问题——手动发起支付正常，但通过APP调用就失败，我帮你梳理几个最可能的原因和对应的解决方案：

1. 最可能的原因：缺少交易金额参数am #

你构建的UPI URL里没有包含am（交易金额）参数！很多UPI应用（比如Google Pay、PhonePe）强制要求这个参数才能发起支付请求。你手动操作的时候肯定是在UPI应用里输入了金额，所以能成功，但通过URL调用时没传这个参数，直接导致支付流程中断。

修复方案： #

添加am参数，并且确保参数值是带两位小数的字符串（比如"50.00"），同时进行URL编码：

// 对所有参数值进行URL编码，避免特殊字符破坏结构
String encodedVpa = URLEncoder.encode(sellerVpa, "UTF-8");
String encodedPayeeName = URLEncoder.encode(payeeName, "UTF-8");
String encodedTxnDesc = URLEncoder.encode(txnDescription, "UTF-8");
String encodedAmount = URLEncoder.encode("100.00", "UTF-8"); // 替换为实际交易金额

String upiPaymentUrl = "upi://pay?pa=" + encodedVpa 
        + "&pn=" + encodedPayeeName 
        + "&tn=" + encodedTxnDesc 
        + "&am=" + encodedAmount 
        + "&cu=INR";

2. 参数未做URL编码，导致格式错误 #

如果你的卖家VPA、收款人姓名或交易描述里包含空格、&、=这类特殊字符，直接拼接URL会导致参数截断或解析错误。比如收款人姓名是"Sanjay Dandekar"，空格没编码的话，pn参数会被截断成"Sanjay"，后续参数失效。

修复方案： #

如上面的代码示例，对每个参数值都使用URLEncoder.encode()进行UTF-8编码，确保URL结构完整。

3. Android 11+包可见性限制（次要但需排查） #

如果你运行的是Android 11及以上系统，系统默认限制了应用对其他应用的可见性。虽然你能启动UPI应用，但部分应用可能因为包可见性问题无法正确接收参数。

修复方案： #

在AndroidManifest.xml中添加精准的包查询声明（推荐），或者全局查询权限：

<!-- 精准查询常用UPI应用，避免使用QUERY_ALL_PACKAGES -->
<queries>
    <package android:name="com.google.android.apps.nbu.paisa.user" /> <!-- Google Pay -->
    <package android:name="com.phonepe.app" /> <!-- PhonePe -->
    <package android:name="net.one97.paytm" /> <!-- Paytm -->
</queries>

<!-- 或者全局权限（不推荐，除非必要） -->
<uses-permission android:name="android.permission.QUERY_ALL_PACKAGES" />

4. Intent启动参数的小细节 #

部分UPI应用可能需要特定的Intent Flags才能正常处理请求，可以尝试添加FLAG_ACTIVITY_NEW_TASK：

Intent intent = new Intent(Intent.ACTION_VIEW);
intent.setData(Uri.parse(upiPaymentUrl));
intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK); // 添加这个Flag
Intent chooser = Intent.createChooser(intent, getString(R.string.payment_title));
startActivityForResult(chooser, Constant.REQUEST_CODE_UPIPAYMENT, null);

快速验证步骤 #

1. 先给URL加上am参数并编码，这是最可能解决问题的步骤；
2. 打印最终生成的upiPaymentUrl，复制到浏览器或者UPI应用里直接打开，看是否能正常发起支付；
3. 如果还是失败，检查参数里是否有特殊字符，或者尝试简化交易描述（比如用纯英文）。

内容的提问来源于stack exchange，提问作者Sanjay Dandekar