错误码

HTTP 状态固定为 200。code=0 表示成功；失败时 data=null。

错误响应

{
  "request_id": "7d5f6832c7494cb28e413f97f8460981",
  "code": 1019,
  "message": "订单号已存在",
  "data": null
}

错误码列表

code	message	处理方式
1000	请求格式不正确	请按接口说明检查方法、路径、JSON 请求体和查询参数。
1001	请求参数格式不正确	检查鉴权参数、订单号及字段类型、长度。
1002	缺少鉴权参数	补齐四个鉴权请求头，每个请求头只允许一个值。
1003	商户凭证无效	检查 APPID 是否正确。
1004	请求时间戳已过期	同步服务器时间，使用当前 Unix 秒级时间戳重新签名。允许偏差为前后 300 秒。
1005	签名验证失败	检查密钥、原始路径和换行规则；密钥刷新后须使用新密钥。
1006	商户已禁用	启用商户后重新请求。
1007	账户不可用	联系服务方核实账户状态。
1008	未配置IP白名单	将调用服务器的出口 IPv4 加入商户白名单。
1009	请求IP不在白名单中	检查调用服务器的出口 IPv4 与白名单配置。
1010	接口不存在	检查请求路径和 API 版本。
1011	账户不存在	联系服务方核实账户是否已开通。
1012	请求方法不支持	使用接口指定的 GET 或 POST 方法。
1013	请求随机串已使用	每次请求（包括重试）生成新的随机串并重新签名。
1014	请求体过大	请求体不得超过 16384 字节；GET 接口不接受请求体。
1015	请求频率超限	每个 APPID 所有接口合计每自然分钟最多 60 次；按 Retry-After 响应头等待后重新签名请求。
1016	服务内部异常	创建订单或申请退款应先查询原单；查询请求可稍后重新签名重试。仍失败时提供 request_id 排查。
1017	服务暂不可用	创建订单或申请退款应先查询原单；查询请求可稍后重新签名重试。仍失败时提供 request_id 排查。
1018	收款金额格式不正确	payment_amount 必须是大于 0 的十进制字符串，最多 24 位整数、2 位小数；不接受科学计数法。
1019	订单号已存在	同一 APPID 下三方订单号不可重复；请查询原订单或使用新的订单号创建。
1020	收款订单不存在	检查当前 APPID 下的 third_order_no；不能查询其他 APPID 的订单。
1021	退款金额格式不正确	refund_amount 必须为正数金额字符串，最多 24 位整数、2 位小数。
1022	收款订单尚未支付	仅已支付订单支持退款。
1023	退款单号已存在且参数不一致	同一 APPID 下退款单号唯一；重试须使用原订单号、退款金额及回调地址。
1024	退款金额超过可退金额	原收款金额减去成功及处理中的退款金额，为当前可退金额。
1025	退款订单不存在	检查当前 APPID 下的 third_refund_no。
1026	收款订单付款人信息不完整	联系服务方核实原收款订单。
1027	回调地址格式不正确	callback_url 可不传或为空字符串；填写时须为有效 HTTPS 地址，最多 2048 字节，不允许账号密码、片段或空白字符。
1028	出款金额格式不正确	payout_amount 必须为大于0的十进制字符串，最多24位整数、2位小数。
1029	出款订单不存在	检查当前 APPID 下的 third_order_no。
1030	收款会员不存在	user_id 使用收款会员的10位用户ID，不能使用 Telegram ID。
1031	收款会员不可用	核实收款会员账户状态。
1032	不能向商户所属账户出款	收款会员不能是当前商户所属会员。
1033	收款机器人暂不可用	联系服务方核实收款机器人状态后重试。
1034	收款订单过期时间不正确	expires_at 须为秒级 RFC 3339 时间，晚于当前时间且不超过 30 分钟；未传或空字符串默认 10 分钟。

重试

参数和鉴权错误应修正后重试。1015 按 Retry-After 等待；1016、1017 可短暂等待后重试。创建订单、申请退款或出款超时，应先查询原单；以结果通知或查询接口中的最终状态判断是否成功。排查问题时提供 request_id。