MPGS调用Retrieve Session接口报Unexpected parameter 'merchantId'如何解决

报错根因 #

你遇到的Unexpected parameter 'merchantId'报错是MPGS接口的参数位置校验不通过导致的：该接口要求merchantId必须作为URL路径的组成部分传入，不允许作为独立的查询参数/请求体参数提交，额外传入该参数就会触发校验失败。

常见错误场景 #

• 你在Postman的「Params」标签页额外添加了merchantId键值对
• 你在请求体（Body）中配置了merchantId相关字段
• 你没有按照规范拼接URL路径，错误把merchantId放在了参数位

解决步骤 #

• 按照官方规范拼接完整请求URL，格式如下，不需要额外添加参数：
  https://<MPGS网关域名>/api/rest/version/<你使用的接口版本号>/merchant/<你的merchantId>/session/<你的sessionId>
  示例：
  https://ap-gateway.mastercard.com/api/rest/version/79/merchant/TEST_MERCHANT_001/session/SESSION_123456789ABC
• 清空Postman「Params」栏所有自定义参数，「Body」栏选择none，该接口为GET请求无需提交请求体。
• 配置接口认证：在「Authorization」标签页选择Basic Auth，用户名字段填merchant.<你的merchantId>，密码字段填你在MPGS商户后台生成的API密钥。
• 重新发送请求即可正常获取session信息。

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