跳至主要內容

交易状态码

TOPPAY Team大约 2 分钟

说明

代收(Pay-In)与代付(Pay-Out)接口、查询与异步通知中均会出现 status(及代付中的 statusMsg)字段。下表适用于全部法币国家,也适用于数字货币代付,以及数字货币代收的回调。数字货币代收查询返回的是统一展示状态(WAITING / SUCCESS / FAILED / EXPIRED),不使用本表字符串,见 数字货币订单查询。若网关返回未列出的扩展值,请以实际响应与运营说明为准。

字段类型

  • 代收:status 一般为 字符串(如 SUCCESS)。
  • 代付:status 一般为 数字(99、0–5),与 订单状态查询 响应一致。

代收状态(Pay-In)

适用于全部法币国家的代收订单、订单查询 与代收回调,以及数字货币代收回调。数字货币代收查询见 数字货币订单查询。

字段值说明
INIT_ORDER订单初始化
NO_PAY未支付
SUCCESS支付成功
PAY_CANCEL撤销
PAY_ERROR支付失败

部分接口示例中可能出现其他字符串状态,请以返回为准。

代付状态(Pay-Out)

适用于全部法币国家的代付订单、订单查询 与代付回调,以及数字货币代付(数值类型)。数字货币的 statusMsg 文案见 数字货币代付。

重要提示

订单状态除了 2、3、4 外,其它状态均为处理中状态,不可将订单直接处理为失败。

字段值说明
99已创建
0待处理
1已受理
2代付成功
3退单
4代付失败
5银行代付中

statusMsg 为可读说明(如 ORDER_RECEIVED_PROCESSING、supplement success!),便于排查,业务判断请以 status 数值为准。

相关文档