注意事项

集成注意事项

时间同步： 请确保服务器时间与标准时间同步，时间戳误差不能超过 5 分钟
参数顺序： 签名计算时必须按照参数名字典序排序
数组处理： 数组参数需要转换为 JSON 字符串，且不进行内部键排序
nonce 一次性： 同一 nonce 在时间窗内只能使用一次，重复提交会被拒绝（防重放）。请勿复用 nonce，也不要在失败重试时原样重发请求参数
商户单号唯一： merchant_order_no 同一商户内唯一，重复建单返回错误；网络超时后可凭同一单号安全重试（返回"已存在"即代表首单已建成，请查单确认）
余额检查： 创建卖单前请确保商户 USDT 余额充足
回调处理： 请正确处理订单状态变更的回调通知
安全存储： 请妥善保管 API 密钥，不要在代码中硬编码或提交到版本控制系统

技术支持

如果在集成过程中遇到问题，请联系：

技术支持邮箱： tech-support@huanyu.com
客服热线： 400-xxx-xxxx

文档更新记录

v1.0 (2025-11-04) - 初始版本，包含买单和卖单创建接口文档
v1.1 (2025-11-04) - 买单和卖单新增三要素验证（customer_name、id_card、mobile 均为必填）
v1.2 (2026-06-28) - 买单三要素失败改为暂存 + H5 补全流程
v1.3 (2026-09-01) - 安全增强：merchant_order_no 商户内唯一（重复建单返回错误，可凭单号安全重试）；nonce 时间窗内一次性（防重放）；修复订单查询接口（orderListApi/orderDetailApi）签名校验问题（此前按本文档签名调用查询接口会返回"API签名验证失败"）
v1.4 (2026-09-01) - 新增官方 SDK 安装文档（PHP / Java / Go / Python 四语言）
v1.5 (2026-09-01) - 创建订单新增 callback_url 选填参数（单级回调地址，订单级优先于商户默认）；订单详情回显该字段