收款查询

根据支付单号查询收款订单状态。

请求接口

POST /open/cashier/trans/query/pay

通用参数

• 请求签名：Authorization Header，详见签名方法
• 客户端信息：Ikudot-Cashier-Client Header，详见客户端信息；

请求参数

参数	必填	类型	说明
pay_no	否	String	支付单号
out_trade_no	否	String	业务系统订单号，长度不超过 64
transaction_id	否	String	交易流水号（支持模糊查询），长度不超过 64
is_refresh	否	Boolean	是否刷新上游渠道状态，默认 false

备注

pay_no、out_trade_no、transaction_id 至少传一个。

响应参数

参数	类型	说明
pay_no	String	支付单号
out_trade_no	String	业务单号
status	Integer	支付状态编码，参见支付状态
status_name	String	支付状态名称
payment	String	支付方式编码，参见支付方式
payment_name	String	支付方式名称
amount	Long	收款金额（分）
refunded	Long	已退款金额（分）
received	String	实收金额，商家承担部分
pay_time	String	支付时间，格式 yyyy-MM-dd HH:mm:ss
expire_time	String	支付超时时间
trade_type	String	交易类型编码，参见交易类型
trade_type_name	String	交易类型名称
result_msg	String	结果说明

请求示例

{
  "pay_no": "PAY20260507000001",
  "is_refresh": true
}

响应示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "pay_no": "PAY20260507000001",
    "out_trade_no": "TS20260507000001",
    "status": 100,
    "status_name": "支付成功",
    "payment": "WXPAY",
    "payment_name": "微信支付",
    "amount": 100,
    "refunded": 0,
    "received": "1.00",
    "pay_time": "2026-05-07 10:00:00",
    "trade_type": "AUTHCODE",
    "trade_type_name": "付款码支付",
    "result_msg": "支付成功"
  }
}