## **商戶打款單結果查詢** **簡要描述**: - 服務商可查詢旗下商戶的打款情況 **請求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 | 非終態：“此類打款單打款成功僅代表轉出成功，不等于最終到賬成功。”終態：“此類打款單打款成功，即最終到賬成功 |