## **商户打款单结果查询** **简要描述**: - 服务商可查询旗下商户的打款情况 **请求URL：** 正式环境- ` /open-api/agent/settlement-order ` **请求方式：** - POST **请求参数：** | 参数名 | 必选 | 类型 | 说明 | | :------ | :--- | :----- | -------------------------------- | | agentId | 是 | string | 代理商id | | billId | 是 | string | 单号 | | sign | 是 | string | 签名值（签名逻辑见下方）32位小写 | | type | 是 | string | 类型：“t0”、“t1”、“T1_Adjust” |    签名值sign示例： MD5（agentId=18566&billId=20170518000000000479&type=t1&key=XXXXXXXXXXX) 说明：参数按首字母英文字典排序拼接参数，最后加上&key=（代理商私钥） 对拼接后的字符串进行md5操作得到sign值 **返回示例** ``` { "data": { "planAmount": 199, "createTime": "2017-09-01 06:24:44.0", "bankretTime": "2017-09-02 06:24:44.0", "suspendAmount": 0, "state": 0, "billId": "20170901000030368488", "merchantId": "9505209088", "realAmount": 199, "failReason": "", "remark":"", "recreateFlag":"0" "bankBranch": "中国建设银行股份有限公司深圳布吉支行" "bankAccount": "621226*********4882", "bankHolder": "*雪真", }, "error_code": "0", "error_msg": "Success" } ``` **返回参数说明** | 参数名 | 类型 | 说明 | | :------------ | :----- | ------------------------------------------------------------ | | billId | String | 单号 | | createTime | String | 创建时间 （创建时间是交易时间的下一天） | | bankretTime | String | 打款时间 | | merchantId | String | 商户号 | | planAmount | int | 应付金额（单位：0.01元） | | suspendAmount | int | 止付金额（单位：0.01元） | | realAmount | int | 实付金额（单位：0.01元） | | state | int | 状态： -1：打款失败； 0：打款中； 1：打款成功； 2：打款退票； 3：冻结出款； | | failReason | String | 失败原因 | | remark | String | 备注： T1打款退票会重新生成一条打款单，财务会根据新生成打款单打款，此时通知时则通过remark字段来关联上次的打款单号，如果再次发生退票，则再重新打款，remark每次只关联上一笔打款单号 | | recreateFlag | String | 打款单是否是重新生成的；0：否 1：是 （T0无该字段） | | bankBranch | String | 银行名称 | | bankAccount | String | 银行账号 | | bankHolder | String | 开户人 | | tag | String | 非终态：“此类打款单打款成功仅代表转出成功，不等于最终到账成功。”终态：“此类打款单打款成功，即最终到账成功 |