## **交易結果查詢** ## - **請求地址**： cgi-bin/lepos\_pay\_gateway.cgi - 測試商戶信息及請求密鑰和回調密鑰請聯系我們獲取。 - 生產環境走完協議流程并且聯調完提交測試報告后，我司運營同事將會提供參數給貴司 - 注：查詢時，除非返回明確的支付成功、支付失敗、訂單關閉等最終狀態，其他錯誤或者未支付狀態，都需要再查詢，直到得到明確的支付狀態。如果超過一段時間還是未支付，可以調用關閉訂單接口。 **參數:** - 請求參數 | 參數名 | 變量名 | 必填 | 限制 | 類型 | 說明 | | :----------- | :------------- | :--- | ---- | ------ | -------------------------------------------------- | | 接口名 | service | M | 無 | string | query_status（此為固定值） | |商戶號|merchant_id|M|10|string|由樂刷分配| |商戶訂單號|third_order_id|O|64|string|選填| |樂刷訂單號|leshua_order_id|O|16|string|third_order_id和leshua_order_id必填1個，優先使用leshua_order_id| |隨機字符串|nonce_str|M|32|string|隨機字符串| |簽名|sign|M|32|string|MD5簽名結果| - 返回參數 | 參數名 | 變量名 | 必填 | 限制 | 類型 | 說明 | | -------------------- | ------------------ | ---- | ---- | ------ | ------------------------------------------------------------ | | 返回狀態碼 | resp_code | M | 無 | string | 0 - 成功，非0 - 失敗。注：此字段是通信標識，業務狀態要看result_code | | 返回錯誤信息 | resp_msg | C | 無 | string | 錯誤描述：resp_code非0時返回 | | 業務結果 | result_code | M | 1 | string | 0 - 成功，非0 - 失敗 | | 錯誤碼 | error_code | O | 無 | string | 參考錯誤碼 | | 錯誤碼描述 | error_msg | O | 無 | string | 錯誤信息描述 | | 商戶號 | merchant_id | M | 10 | string | 由樂刷分配 | |通道商戶號|sub_merchant_id|M|無|string|微信、支付寶、QRC商戶號| | 商戶訂單號 | third_order_id | M | 64 | string | 商戶內部訂單號 | | 隨機字符串 | nonce_str | M | 32 | string | 隨機字符串 | | 簽名 | sign | M | 32 | string | MD5簽名結果 | | 訂單狀態 | status | M | 無 | string | 詳見下方訂單狀態 | | 樂刷訂單號 | leshua_order_id | M | 32 | string | 樂刷訂單號 | | 訂單金額 | amount | M | 無 | string | | | 支付類型 | pay_way | M | 無 | string | 詳見下方支付類型 | | 支付完成時間 | pay_time | C | 無 | string | 支付成功時才返回 | | 銀行類型 | bank_type | O | 無 | string | 詳見下方銀行類型 | | 用戶openid | openid | C | 無 | string | 支付成功時才返回 | | 微信、支付寶等訂單號 | out_transaction_id | C | 無 | string | 支付成功時才返回 | | 用戶子標識 | sub_openid | C | 無 | string | 支付成功時才返回。微信：微信公眾號APPID下用戶唯一標識；支付寶：買家的支付寶用戶ID | | 附加數據 | attach | C | 96 | string | 支付成功時原樣返回 | | 交易類型 | trade_type | C | 無 | string | 支付成功時才返回：MICROPAY-條碼支付，NATIVE-原生掃碼支付，JSAPI-公眾號支付、服務窗支付，APP--app支付，H5Pay-支付支付，SmPgPay-小程序支付，JSAPIQuick-簡易支付 | | 通道訂單號 | channel_order_id | C | 無 | string | 支付成功時才返回 | | 通道訂單時間 | channel_datetime | C | 無 | string | 支付成功時才返回 | | 支付寶紅包金額 | coupon | C | 無 | string | 支付成功時才返回，單位(分) | | 應結算金額 | settlement_amount | C | 無 | string | 實際結算金額，支付成功時才返回 | | 折扣優惠金額 | discount_amount | C | 無 | string | 訂單優惠金額，支付成功時才返回 | | 優惠詳情 | promotion_detail | O | 無 | string | 優惠詳情說明：[微信官方文檔](https://pay.weixin.qq.com/wiki/doc/api/danpin.php?chapter=9\_101&index=1) | | 活動標志 | active_flag | O | 無 | string | 活動標志。WXLZ：微信綠洲；ZFBLH：支付寶藍海 | | 買家實付金額 | buyer_pay_amount | O | 無 | String | 微信、支付寶此值有效 | ## 支付類型 | 類型 | 說明 | 狀態 | | ------ | ---------- | ---- | | WXZF | 微信 | 支持 | | ZFBZF | 支付寶 | 支持 | | UPSMZF | 銀聯二維碼 | 支持 | **訂單狀態** | 值 | 說明 | | :--- | :------- | | 0 | 支付中 | | 2 | 支付成功 | | 6 | 訂單關閉 | | 8 | 支付失敗 | | 10 | 退款中 | | 11 | 退款成功 | | 12 | 退款失敗 | **付款銀行類型** | 通道 | 說明 | | ------ | ------------------------------------------------------------ | | 微信 | <https://pay.weixin.qq.com/wiki/doc/api/mch_bank.php?chapter=4_2> | | 支付寶 | <https://alipay.open.taobao.com/doc2/detail?treeId=26&articleId=103259&docType=1> | | 銀聯二維碼 | 1 - 借記卡 2- 貸記卡 | **注意事項說明** - 所有涉及到金額的單位都位分，幣種為RMB，最小為1分，不允許出現小數 - 文檔中參數，標識為必填必須上送（如果缺少會報錯），非必填的可填可不填 - 返回參數中必填為是的參數是一定會返回的，必填為否的參數則不一定返回，因升級或配置等情況實際返回參數可能不會跟文檔完全一致，必須以實際接收到的參數為準