通过商家明细单号查询明细单

商户明细单号查单接口。商户可以通过该接口查询单笔转账明细单。返回消息中包含支付平台明细单号、明细状态、转账金额、失败原因、收款用户姓名、用户OpenID等信息。

返回响应

🟢200成功

application/json

Body

mchid

string

商户号

必需

支付平台分配的商户号

out_batch_no

string

商家批次单号

必需

商户系统内部的商家批次单号，在商户系统内部唯一

batch_id

string

支付平台批次单号

必需

平台批次单号，商家转账系统返回的唯一标识

appid

string

微信appid

必需

微信appid

out_detail_no

string

商家明细单号

必需

商户系统内部区分转账批次单下不同转账明细单的唯一标识

detail_id

string

平台明细单号

必需

平台支付系统内部区分转账批次单下不同转账明细单的唯一标识

detail_status

string

明细状态

必需

【明细状态】 INIT: 初始态。系统转账校验中 WAIT_PAY: 待确认。待商户确认, 符合免密条件时, 系统会自动扭转为转账中 PROCESSING:转账中。正在处理中，转账结果尚未明确 SUCCESS:转账成功 FAIL:转账失败。需要确认失败原因后，再决定是否重新发起对该笔明细单的转账（并非整个转账批次单）

transfer_amount

integer

转账金额

必需

转账金额单位为“分”

transfer_remark

string

转账备注

必需

单条转账备注（微信用户会收到该备注），UTF8编码，最多允许32个字符

fail_reason

string

明细失败原因

可选

如果转账失败则有失败原因

openid

string

收款用户openid

必需

商户appid下，某用户的openid

user_name

string

收款用户姓名

可选

initiate_time

string

转账发起时间

必需

转账发起的时间，按照使用rfc3339所定义的格式，格式为YYYY-MM-DDThh:mm:ss+TIMEZONE

update_time

string

明细更新时间

必需

明细最后一次状态变更的时间，按照使用rfc3339所定义的格式，格式为YYYY-MM-DDThh:mm:ss+TIMEZONE

示例

{
  "mchid": "string",
  "out_batch_no": "string",
  "batch_id": "string",
  "appid": "string",
  "out_detail_no": "string",
  "detail_id": "string",
  "detail_status": "string",
  "transfer_amount": 0,
  "transfer_remark": "string",
  "fail_reason": "string",
  "openid": "string",
  "user_name": "string",
  "initiate_time": "string",
  "update_time": "string"
}

请求参数

示例代码

返回响应