Razorpay OAuth商户连接流程授权URL访问报错求助

核心报错原因 #

当前触发授权报错的核心问题是参数来源和配置不匹配，具体如下：

• 误用普通API密钥作为OAuth凭证：从密钥管理页面获取的是普通支付接口用的Key ID，不是OAuth应用专属的client_id。Razorpay的OAuth授权流程要求必须先创建独立的第三方合作伙伴OAuth应用，生成的专属client_id才能用于授权链接拼接，普通支付密钥完全不支持OAuth鉴权逻辑，这是触发invalid_client类报错的最常见原因。
• 回调地址未提前报备：拼接在链接里的redirect_uri必须和创建OAuth应用时提前录入的允许回调地址完全一致，包含协议、域名、端口、路径全量匹配，本地开发用的localhost地址也需要提前加入测试环境回调白名单，未录入的地址会直接触发授权校验失败。
• 权限范围不匹配：链接中传入的scope参数必须和创建OAuth应用时申请的权限范围一致，如果创建应用时没有勾选对应read_only权限，传参后也会被拦截。

修复步骤 #

1. 创建专属OAuth应用：不要在普通支付密钥管理页面取参数，进入合作伙伴应用模块创建第三方OAuth应用，填写应用基础信息，提前把本地调试用的回调地址http://localhost:3000/admin-home加入测试环境允许回调列表，勾选需要的read_only权限，提交后拿到应用专属的client_id和client_secret。
2. 重新拼接授权链接：用拿到的OAuth专属client_id替换原链接里的普通密钥ID，确认所有参数和应用后台配置完全一致，最终拼接的链接格式如下：

   https://auth.razorpay.com/authorize?client_id={替换为你的OAuth专属client_id}&response_type=code&redirect_uri=http://localhost:3000/admin-home&scope=read_only&state=NOBYtv8r6c75ex6WZ
   

3. 本地调试校验：测试阶段使用测试环境的OAuth应用凭证，不要混用生产环境client_id，确认本地3000端口服务正常启动，再打开授权链接即可正常跳转到商户授权页面。

从报错表现判断，当前遇到的问题90%以上概率是误用普通支付Key ID充当OAuth client_id导致的，优先排查这个点即可快速解决问题。

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