Square Checkout生产环境API支付提交失败问题求助

问题概述 #

在WPF应用中调用Square Checkout API，生产环境可成功获取支付URL并在浏览器控件打开，但使用测试卡提交支付时弹出错误：

We are unable to complete your request at this time. Please try again.
需要实现文档描述的支付成功结果页。

排查与修复步骤 #

• 切换到测试环境密钥与端点：确保调用API时使用Square测试密钥，而非生产密钥。生产环境不支持测试卡交易，必须使用测试环境的API地址和对应密钥。
• 使用官方标准测试卡：严格使用Square官方指定的测试卡信息，例如卡号4111 1111 1111 1111，过期日期选未来任意年月，CVV填任意3位数字。避免使用非官方测试卡或格式错误的卡号。
• 验证浏览器控件兼容性：WPF默认WebBrowser控件基于旧IE内核，可能不兼容Square支付页面的现代脚本。先在Chrome/Edge等现代浏览器中打开支付URL测试，若能正常完成支付，说明是控件兼容性问题，建议替换为CefSharp等基于Chromium的WPF浏览器控件。
• 检查API请求参数合法性：
  • 确认金额、货币代码与账号地区匹配（测试环境对货币有地域限制）
  • 确保redirect_url可正常访问（Square支付完成后需跳转至此，地址不可达会导致流程异常）
  • 确认请求中是否正确启用测试模式相关配置（部分API需显式指定测试标识）
• 查看Square后台错误日志：登录Square开发者控制台，查看API请求日志和支付错误详情，里面会提供具体错误码和原因，比如权限不足、参数错误或账号配置问题。

快速验证方案 #

直接使用Square官方Checkout API测试工具生成支付URL，测试支付流程，排除WPF应用代码层面的问题。

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