Skip to main content

​
📄 正文

无论您是想验证授权回调能否正确解析，还是想在上线前测试「刷卡 → 授权转发 → 入账」完整流程，都可以在沙盒环境中完成。测试不需要接入真实卡组织或使用真实资金，也不会影响真实持卡人。DCS 为接入机构提供与生产环境采用相同授权流程的沙盒环境，便于在接入早期反复验证授权决策逻辑。

​
后端是否支持模拟？

支持，但范围有限。 截至当前版本，合作伙伴自管接口提供 1 个模拟接口：
当前沙盒模拟能力聚焦于「授权」环节，清算、3DS、保证金等独立模拟接口尚在规划中。如您在测试中需要模拟上述场景，请与 DCS 团队联系以确认可行的替代方案。

​
沙盒能为您做什么

fund-auth 模拟接口会触发一次真实的授权转发流程：DCS 收到模拟请求后，按生产同样的流程把授权通知推送到接入机构配置的 authUrl，由接入机构返回放行 / 拒绝决策。因此它适合用于：
  • 验证授权通知的 RSA 双向签名 + 加解密 是否正常；
  • 验证接入机构的授权决策逻辑（额度判断、风控规则、超时处理）；
  • 验证 EXPEND（消费）、REFUND（退货）、REVERSAL（消费冲正）三类场景下，您的系统状态流转是否正确。

​
沙盒环境地址

模拟接口仅在沙盒环境可用。生产环境会直接拦截该路径并返回 OPERATION_NOT_SUPPORT，请勿在生产环境调用 simulation 相关接口。

​
开始模拟前的前置条件

鉴权头、RSA 密钥生成（openssl）与 IP 白名单的完整说明，见 接入与鉴权。

​
最小请求示例

请求字段（接口：POST /open-api/simulation/v1/fund-auth）：

​
最小响应示例

响应字段：
统一响应结构：所有接口都返回 { code, message, messageDetail, data }。code 表示系统调用结果（如 SYS_SUCCESS），业务结果须以 data 内字段（此处为 approved）为准——code=SYS_SUCCESS 仅代表请求被正确受理，不代表授权通过。请勿仅凭 code 判断业务成败。messageDetail 为面向终端的提示对象，平时可能为 null。响应结构的完整约定见 接入与鉴权。

​
完整流程验证建议

  1. 调 fund-auth（authType=EXPEND）→ 观察 DCS 是否向您的 authUrl 推送授权通知；
  2. 在 authUrl 侧验签、解密、做出决策并签名返回；
  3. 检查 fund-auth 响应中的 data.approved 是否与您返回的决策一致；
  4. 再用 authType=REFUND / REVERSAL 重复，验证退货与冲正路径。

​
下一步

逐场景的模拟用例（消费 / 退货 / 冲正，以及清算、部分/多笔、3DS 等待确认能力的处理建议），见 模拟交易。