FAQ
常见问题
接入与使用中的高频问题都在这里。仍未解决的，欢迎联系客服。
Q1下单失败（code 3003 / 3001）怎么办？＋
3001 表示所有候选渠道均不可用（全部失败或熔断中），3003 表示供应商侧下单失败。排查顺序：① 控制台「渠道管理」点「连通性测试」验证密钥；② 查订单详情里的供应商返回报文（supplier_msg）；③ 确认供应商侧余额/库存充足；④ 若渠道处于熔断，等待冷却或手动恢复。查询类接口不计费，可放心重试查单。
Q2收不到异步回调怎么办？＋
按顺序排查：① 确认回调地址是 HTTPS 公网可达地址（内网/localhost 收不到）；② 看控制台「回调记录」的转发状态与响应码，失败可一键补发；③ 确认你的服务端正确返回纯文本
success，否则会重试 5 次后放弃；④ 以「订单查询」接口主动查单兜底（务必做幂等）。回调会带 HMAC 签名，验签失败请检查是否误改了 body 原文。Q3密钥填错了有什么表现？＋
分两种：调用我们的 API 签名错 → 返回 code 1001；供应商渠道的 AppKey/Secret 错 → 下单转发被供应商拒绝（supplier_msg 中可见对方的鉴权错误）。前者核对 AccessKey/Secret 与签名串的换行拼接；后者在「渠道管理」用连通性测试一键验证，替换密钥即可，无需改代码。
Q4渠道维护 / 供应商宕机影响我吗？＋
影响会被自动控制。渠道连续失败达到阈值会自动熔断降级，流量自动切换到其他可用渠道（前提是该商品绑定了多渠道）。单一渠道故障不会导致整体不可用。建议关键商品至少绑定 2 个供应商渠道做容灾。
Q5比价的差价怎么算？钱经过平台吗？＋
不经过。成交成本 = 系统选中渠道的实际报价，供应商直接从你在它那边的余额扣款，我们不加价、不抽成、不碰资金。开启比价后系统自动选低价渠道，相当于帮你在多个供应商之间做「自动货比三家」。
Q6到账延迟是什么原因？＋
中转链路本身是毫秒级转发，延迟主要来自供应商侧处理（部分商品供应商本身是异步履约）。订单状态以异步回调为准，期间可随时用「订单查询」接口轮询。若供应商长时间不回传，可在订单详情发起查询或联系对应供应商客服（平台只做转发，无权干预供应商履约时效）。
Q7为什么限制调用频率（code 1101）？＋
限流用于保护渠道稳定性与防止异常高频调用，默认配额对正常业务完全够用。如需更高并发，在控制台查看当前配额或联系客服调整。另外建议按退避策略重试（如 1s/2s/4s），避免瞬时打满。
Q8密钥安全吗？平台能看到我的供应商密钥吗？＋
供应商密钥采用加密存储（AES-256 + 密钥派生），入库后任何页面（包括平台管理员后台）都不展示明文，仅在向供应商发请求时于服务内存中解密使用。但请注意：密钥的获取、保管、轮换责任在你，泄露风险由密钥持有方承担，详见服务协议。