UU 收款
UU 收款
API 文档帮助中心进入控制台
CTRL K
API 文档帮助中心进入控制台

开始接入

接入概览快速开始请求签名与鉴权

接口参考

用户与充值地址订单与查询充值回调提现与退款

排查与处理

错误与重试

错误与重试

根据 HTTP 状态和错误信息,定位问题并安全重试。

响应结构

{"error": "invalid signature"}

当前接口使用 HTTP 状态与 error 文本描述失败,没有额外的数字业务错误码。

HTTP 状态常见含义建议处理
400参数不完整、金额或地址无效检查参数后重新提交
401鉴权失败、时间戳无效、请求重放按下表检查签名与凭据
403商户尚未激活等访问限制联系平台管理员核查状态
404当前商户下不存在该资源核对平台 UUID 与所属商户
409主钱包未配置、业务编号冲突等解决配置或幂等冲突后再提交
500内部处理失败保存脱敏请求信息,稍后重试或联系管理员
503钱包或密钥服务配置不可用联系平台管理员处理

常见错误

错误信息排查方向
API authentication required是否缺少四个鉴权请求头
invalid timestamp是否使用秒级时间戳,时钟误差是否超过 300 秒
invalid credentialsAPI Key 是否有效、是否已撤销、商户是否激活
invalid signatureSecret、路径、请求体字节与拼接格式是否一致
replayed request是否复用了 Nonce
merchant settlement wallet not configured是否配置有效商户主钱包
customer deposit address not configured是否先创建了该用户及对应资产的充值地址
order already exists with different data是否对同一订单号提交了不同参数
same deposit address already has an active order for this amount同一地址同一金额是否已有待支付订单

请求超时后如何处理

超时不能说明请求没有成功。创建用户时复用原 external_id,创建订单时复用原 order_no,提现时复用原幂等键。每次 HTTP 重试都生成新的 Nonce、时间戳和签名。

不要在失败后随意更换业务编号,以免把重试变成新业务。已有订单 UUID 时,应先查询状态。

提交排查信息

请提供发生时间、请求路径、HTTP 状态、错误文本、业务编号和交易哈希。隐藏 API Secret、回调密钥、密码、私钥及完整鉴权头。

账户或收款操作问题可先查看帮助中心的常见问题。

提现与退款

上一篇

本页内容

响应结构常见错误请求超时后如何处理提交排查信息