错误讯息遮罩功能
本功能允许平台运营人员为商户开启「错误讯息遮罩」，将系统产生的详细技术错误讯息替换为统一的客制化讯息，以提升商户端的资讯安全性。
使用场景
当支付交易发生异常时,系统会产生详细的错误讯息。为了避免敏感资讯外泄,平台可以选择开启此功能,将原始错误讯息替换为统一的遮罩讯息。
如何开启此功能
- 登入后台管理系统
- 进入「商户管理」>「商户列表」
- 找到目标商户,点击「编辑」
- 在商户设定页面中,找到「遮罩上游错误」选项
- 开启开关并储存设定
对商户的影响
开启此功能后,商户在以下场景会看到遮罩后的错误讯息:
1. API 回应
当商户透过 API 发起交易请求时,若发生错误,API 回应将显示统一的遮罩讯息,而非原始的技术错误详情。
遮罩前（范例）:
{
"code": "9999",
"message": "Channel timeout: connection refused to upstream server"
}
遮罩后:
{
"code": "9999",
"message": "交易暂时无法处理，请稍后重试"
}
2. 商户后台
当商户登入自己的后台查看订单详情时,错误讯息栏位将显示遮罩后的讯息,无法看到原始的技术错误内容。
| 栏位 | 遮罩前 | 遮罩后 |
|---|---|---|
| 失败原因 | Channel response: insufficient balance | 交易暂时无法处理，请稍后重试 |
注意事项
- ⚠️ 仅影响商户端显示：平台管理员仍可在后台查看完整的原始错误讯息
- ⚠️ 即时生效：开启或关闭设定后,立即对新的交易生效
- ⚠️ 历史讯息不变：已记录的历史订单错误讯息不会被修改
常见问题
Q: 开启遮罩后,商户如何排查问题?
商户可联系平台客服,由平台人员查看原始错误讯息后协助排查。
Q: 是否可以自订遮罩讯息内容?
目前遮罩讯息为系统预设,如需自订请联系技术支援。
Q: 此设定是否影响交易成功率?
此功能仅影响错误讯息的显示方式,不会影响交易处理流程或成功率。