基于BlueSnap SDK的Android Google Pay支付异常排查求助

我明白你现在遇到的Google Pay集成问题有多头疼——毕竟卡片支付都正常跑通了，偏偏Google Pay卡在这里。咱们一步步来排查这个"Unexpected developer error"的问题，帮你搞定它，让Google Pay支付能正常通过BlueSnap处理，并且同步到沙箱控制台。

1. 先确认BlueSnap沙箱的Google Pay基础配置 #

• 首先去你的BlueSnap沙箱控制台，确保Google Pay支付方式已经被启用。有时候默认是关闭的，需要手动到支付设置里开启，并且配置好相关参数（比如商户名称、支持的货币等）。
• 验证merchantId的正确性：看你代码里merchantId = blueSnapService.getsDKConfiguration().getMerchantId()这一行，一定要确保初始化BlueSnap SDK时传入的是沙箱环境的商户ID，不是生产环境的。可以加个Log打印这个值，确认它和你沙箱控制台里的商户ID完全一致。

2. 检查Google Pay测试模式与网关参数 #

• 你的代码里设置了sdkRequest.setGooglePayTestMode(googlePayTestModeSwitch.isChecked())，务必确保测试模式开关是打开的。因为你用的是BlueSnap沙箱环境，如果测试模式关闭，Google Pay会尝试连接生产环境，两者不匹配直接就会报错。
• 确认网关标识是否正确：你的代码里用了GATEWAY_TOKENIZATION_NAME，这个值必须是"bluesnap"（BlueSnap官方要求的网关名称）。如果这个值写错了，Google Pay无法正确把支付令牌发送给BlueSnap，必然会触发开发者错误。

3. 验证金额与货币的合法性 #

• 检查sdkRequest里的金额和货币格式：货币代码必须符合ISO 4217标准（比如"USD"、"EUR"，不能是小写或者非标准代码），金额必须是正数且小数位数不超过两位（Google Pay对金额格式要求很严格）。虽然你代码里已经做了金额大于0的检查，但还是要确认传递到Google Pay请求时的最终金额（包含税费）是合法的。
• 你的TaxCalculator逻辑里，计算税费后的总金额也要符合上述要求，比如priceDetails.getSubtotalAmount() * taxRate不能出现超过两位小数的情况，必要时可以做四舍五入处理。

4. 抓取详细错误日志（关键步骤） #

你现在只看到了表面的错误提示，得拿到更详细的错误信息才能定位问题：

• 在createPaymentDataRequest方法里，给futurePaymentData添加失败监听，捕获具体异常：

  Task<PaymentData> futurePaymentData = googlePayClient.loadPaymentData(request);
  futurePaymentData.addOnFailureListener(e -> {
      Log.e(TAG, "Google Pay request failed with detail: ", e);
      // 这里可以把错误信息弹出来，方便调试
      runOnUiThread(() -> Toast.makeText(getApplicationContext(), "Error: " + e.getMessage(), Toast.LENGTH_LONG).show());
  });
  

• 同时查看BlueSnap SDK的日志输出，看看有没有关于Google Pay请求的错误信息，比如令牌生成失败、网关通信超时等。

5. 设备与Google Play服务兼容性检查 #

• 确保测试设备上的Google Play服务是最新版本，旧版本可能不支持Google Pay的沙箱测试特性。
• 测试设备需要添加Google Pay沙箱测试卡（比如卡号4111 1111 1111 1111，有效期填未来的月份/年份，CVV填123），并且登录了有效的Google账号。

6. 后续同步支付记录的确认 #

等Google Pay支付成功后，要确保支付记录能同步到BlueSnap沙箱控制台：

• 检查BlueSnap沙箱控制台的交易记录页面，默认应该会显示所有成功的交易（包括Google Pay的）。如果没显示，确认你的支付请求里的金额、商户ID等参数都正确，并且BlueSnap沙箱的交易日志没有报错。

按照上面的步骤逐一排查，应该能找到问题所在。大多数情况下，这类错误都是配置参数不匹配或者测试模式没开导致的，仔细核对每一项应该就能解决。

内容的提问来源于stack exchange，提问作者Asad Alii