Skip to content

错误码

所有开放接口(/v1/open/payments*)失败时返回 {"code":"<错误码>","message":"<错误说明>","data":null}

HTTPcode场景
400PARAM_INVALID参数错误(message 给出具体原因;含 wechat_jsapi 缺 openid/长度不在 16~64、openid 与渠道应用ID 不同源)
401INVALID_SIGNATURE签名不符/缺头(不区分细节,防探测)
401TIMESTAMP_EXPIRED时间戳超 ±5 分钟
401REPLAY_NONCEnonce 重复(8h 窗口)
403APP_DISABLED应用被停用
429RATE_LIMITED超限流(默认 100 QPS/应用)
409OUT_TRADE_NO_CONFLICT同号不同额(创建接口为 out_trade_no、退款接口为 out_refund_no 冲突)
404ORDER_NOT_FOUND单号不存在或不属于本应用
409ORDER_NOT_PAYABLE订单非待支付(拉起段)
409ORDER_NOT_REFUNDABLE订单不可退(非 paid/已全额退)
400REFUND_AMOUNT_INVALID非全额/超额(一期仅全额退)
400AMOUNT_OUT_OF_RANGE金额不在任何收款账户单笔限额内(商户 per_transaction_min/max 配置;创建时即校验,调整金额后重试)
503NO_AVAILABLE_CHANNEL无可用支付通道(限额/熔断/配置)
503CHANNEL_SUB_APPID_MISSING商户微信主体通道未配置渠道应用ID(channel_app_id)——运营在管理后台配置后恢复,调用方无法自修(仅 prepay wechat_jsapi)
400OAUTH_CODE_REQUIRED / OAUTH_CODE_EXPIRED收银台微信内授权引导(前端自动处理,通常无需感知)
500INTERNAL_ERROR平台内部错误

成功响应:{"code":"OK","message":"ok","data":{...}}