## **查詢旗下商戶打款失敗明細** **請求URL：** 正式環境 - /open-api/agent/agent-fail-settlement-order ` **請求方式：** - POST - application/x-www-form-urlencoded **簽名算法（sign）** sign= Base64(md5(lepos+渠道商固定key值+data字符串值)) 注： data字符串為urlencode之前的JSON字符串 **參數：** | 參數名 | 必選 | 類型 | 說明 | | :---------- | :--- | :----- | ---------- | | version | M | String | 版本號 | | agentId | M | String | 代理商編號 | | sign | M | String | 驗簽字符串 | | reqSerialNo | M | String | 隨機字符串 | | data | M | String | 修改字符串 | **data參數說明** | 參數名 | 必選 | 類型 | 說明 | | :----- | :--- | :----- | -------------------------------- | | date | M | string | 打款單的創建日期 “2019-03-02” | | type | M | string | 類型：“T0”、“T1” 、“Withdraw ” | | pageNo | M | int | 頁碼(頁碼超出總頁數后返回第一頁) | 符號解釋： M（強制） C（條件下強制） O（可選） **返回示例** ``` { "totalCount": 2, "pageNo": 1, "pageSize": 20, "error_code": "0", "list": [ { "billId": "20190302000134628699", "createTime": "2019-03-02 04:32:28.0", "bankretTime": "2019-03-02 04:35:09.0", "merchantId": "5791104399", "planAmount": 217, "suspendAmount": 0, "realAmount": 217, "state": 8, "failReason": "失敗-輸入的卡號無效，請確認后輸入", "remark": "客戶賬T1待結算賬本|", "recreateFlag": 0, "bankAccount": "621232*********4727", "bankHolder": "*俠夢", "bankBranch": "中國建設銀行股份有限公司深圳布吉支行" }, { "billId": "20190302000115679288", "createTime": "2019-03-02 04:22:06.0", "bankretTime": "2019-03-02 04:35:09.0", "merchantId": "1921453688", "planAmount": 170, "suspendAmount": 0, "realAmount": 180, "state": 8, "failReason": "失敗-持卡人身份信息或手機號輸入不正確，驗證失敗", "remark": "客戶賬T1待結算賬本|", "recreateFlag": 0, "bankAccount": "628300*********8784", "bankHolder": "*搖", "bankBranch": "中國建設銀行股份有限公司深圳布吉支行" } ], "error_msg": "Success" } ``` **返回參數說明** | 參數名 | 類型 | 說明 | | :------------ | :----- | ------------------------------------------------------------ | | billId | String | 單號 | | createTime | 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 | 備注： D1打款退票會重新生成一條打款單，財務會根據新生成打款單打款，此時通知時則通過remark字段來關聯上次的打款單號，如果再次發生退票，則再重新打款，remark每次只關聯上一筆打款單號 | | recreateFlag | String | 打款單是否是重新生成的；0：否 1：是 （D0無該字段） | | bankBranch | String | 銀行名稱 | | bankAccount | String | 銀行賬號 | | bankHolder | String | 開戶人 | | tag | String | 非終態：“此類打款單打款成功僅代表轉出成功，不等于最終到賬成功。”終態：“此類打款單打款成功，即最終到賬成功 | | bankretTime | String | 打款單更新時間 |