.Net应用集成Adyen调用Sessions接口返回401未授权报错

你触发的{"status":401,"errorCode":"000","message":"HTTP Status Response - Unauthorized","errorType":"security"}是Adyen .NET集成中非常高发的鉴权报错，大量开发者使用官方在线支付示例时都遇到过同类问题，和本地localhost运行环境没有任何关系，全部由配置错漏导致，核心原因集中在以下几点：

• 环境与API Key不匹配：Adyen的测试环境（TEST）和生产环境（LIVE）凭据完全物理隔离，官方示例默认配置对接测试环境，如果你填入生产环境生成的API Key，或是把测试Key填到生产环境配置中，会直接返回401。另外复制API Key时如果带入前后空格、换行符，或是使用了已过期、已吊销的Key，也会触发完全相同的报错。
• API Key缺少对应权限：在Adyen后台生成API Key时，必须手动勾选Checkout服务的访问权限，未开通Checkout读写权限的Key就算值完全正确，调用_checkout.Sessions(sessionsRequest)接口时也会被安全规则拦截。
• 生产环境漏配专属端点前缀：如果你把示例代码的环境从默认的TEST切换为LIVE，除了替换生产环境API Key、商户号之外，必须配置LiveEndpointUrlPrefix参数（值为Adyen后台分配给对应商户的专属URL前缀），漏填该参数会导致请求打到错误的生产集群节点，直接返回401。
• 商户号（Merchant Key）配置错误：填入的商户号必须是当前API Key被授权访问的结算层级商户号，误填公司层级账户名、其他未授权商户号都会触发鉴权失败。

注意：你配置的Client Key仅用于前端支付组件的鉴权，和服务端Sessions接口的鉴权逻辑完全无关，排查当前报错时不需要浪费时间核对Client Key配置。

1. 先确认代码中配置的环境类型，匹配对应环境后台生成的API Key，复制Key后注意清理前后多余的空白字符再硬编码到代码中。
2. 登录对应环境的Adyen管理后台，找到当前使用的API凭据，确认已勾选Checkout服务下的支付相关权限，权限修改后等待1-2分钟生效再重试请求。
3. 如果对接生产环境，检查是否已正确填写LiveEndpointUrlPrefix参数。
4. 核对请求中传入的商户号，和API凭据绑定的授权商户号完全一致。

这类401报错90%以上都可以通过以上步骤定位解决，不需要修改官方示例本身的业务逻辑代码。

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