微信支付關(guān)閉訂單開發(fā)CloudPay.closeOrder()

CloudPay.closeOrder()

支持端：云函數(shù) 2.0.2

關(guān)閉訂單

說明

以下情況需要調(diào)用關(guān)單接口：商戶訂單支付失敗需要生成新單號(hào)重新發(fā)起支付，要對(duì)原訂單號(hào)調(diào)用關(guān)單，避免重復(fù)支付;系統(tǒng)下單后，用戶支付超時(shí)，系統(tǒng)退出不再受理，避免用戶繼續(xù)，請(qǐng)調(diào)用關(guān)單接口。 注意：訂單生成后不能馬上調(diào)用關(guān)單接口，最短調(diào)用時(shí)間間隔為5分鐘。*

參數(shù)說明

字段名變量名必填類型示例值描述

子商戶號(hào)sub_mch_id是String(32)1900000109微信支付分配的子商戶號(hào)

商戶訂單號(hào)out_trade_no是String(32)1217752501201407033233368018商戶系統(tǒng)內(nèi)部訂單號(hào)，要求32個(gè)字符內(nèi)，只能是數(shù)字、大小寫字母_-

隨機(jī)字符串nonce_str是String(32)5K8264ILTKCH16CQ2502SI8ZNMTM67VS商戶系統(tǒng)內(nèi)部的訂單號(hào),32個(gè)字符內(nèi)、可包含字母, 其他說明見安全規(guī)范

返回值說明

字段名變量名必填類型示例值描述

返回狀態(tài)碼returnCode是String(16)SUCCESSSUCCESS/FAIL

返回信息returnMsg否String(128)簽名失敗返回信息，如非空，為錯(cuò)誤原因。如 簽名失敗、參數(shù)格式校驗(yàn)錯(cuò)誤

以下字段在returnCode為SUCCESS的時(shí)候有返回

字段名變量名必填類型示例值描述

服務(wù)商的APPIDappid是String(32)wxd678efh567hg6787服務(wù)商商戶的APPID

商戶號(hào)mch_id是String(32)1230000109微信支付分配的商戶號(hào)

小程序的APPIDsub_appid是String(32)wx8888888888888888微信分配的小程序ID

子商戶號(hào)sub_mch_id是String(32)1900000109微信支付分配的子商戶號(hào)

隨機(jī)字符串nonce_str是String(32)5K8264ILTKCH16CQ2502SI8ZNMTM67VS隨機(jī)字符串，不長(zhǎng)于32位

簽名sign是String(32)C380BEC2BFD727A4B6845133519F3AD6簽名，驗(yàn)證簽名算法

業(yè)務(wù)結(jié)果result_code是String(16)SUCCESSSUCCESS/FAIL

業(yè)務(wù)結(jié)果描述result_msg是String(32)OK對(duì)于業(yè)務(wù)執(zhí)行的詳細(xì)描述

錯(cuò)誤代碼err_code否String(32)SYSTEMERROR詳細(xì)參見下文錯(cuò)誤列表

錯(cuò)誤代碼描述err_code_des否String(128)系統(tǒng)錯(cuò)誤結(jié)果信息描述

錯(cuò)誤碼

名稱描述原因解決方案

ORDERPAID訂單已支付訂單已支付，不能發(fā)起關(guān)單訂單已支付，不能發(fā)起關(guān)單，請(qǐng)當(dāng)作已支付的正常交易

SYSTEMERROR系統(tǒng)錯(cuò)誤系統(tǒng)錯(cuò)誤系統(tǒng)異常，請(qǐng)重新調(diào)用該API

ORDERCLOSED訂單已關(guān)閉訂單已關(guān)閉，無法重復(fù)關(guān)閉訂單已關(guān)閉，無需繼續(xù)調(diào)用

SIGNERROR簽名錯(cuò)誤參數(shù)簽名結(jié)果不正確請(qǐng)檢查簽名參數(shù)和方法是否都符合簽名算法要求

REQUIRE_POST_METHOD請(qǐng)使用post方法未使用post傳遞參數(shù)請(qǐng)檢查請(qǐng)求參數(shù)是否通過post方法提交

XML_FORMAT_ERRORXML格式錯(cuò)誤XML格式錯(cuò)誤請(qǐng)檢查XML參數(shù)格式是否正確