微信小程序云開發(fā)SDK文檔 微信支付·關(guān)閉訂單

2020-07-27 14:27 更新

CloudPay.closeOrder()

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

關(guān)閉訂單

說明

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

參數(shù)說明

字段名變量名必填類型示例值描述
子商戶號sub_mch_id是String(32)1900000109微信支付分配的子商戶號
商戶訂單號out_trade_no是String(32)1217752501201407033233368018商戶系統(tǒng)內(nèi)部訂單號，要求32個字符內(nèi)，只能是數(shù)字、大小寫字母_-
隨機(jī)字符串nonce_str是String(32)5K8264ILTKCH16CQ2502SI8ZNMTM67VS商戶系統(tǒng)內(nèi)部的訂單號,32個字符內(nèi)、可包含字母, 其他說明見安全規(guī)范

返回值說明

字段名變量名必填類型示例值描述
返回狀態(tài)碼returnCode是String(16)SUCCESSSUCCESS/FAIL
返回信息returnMsg否String(128)簽名失敗返回信息，如非空，為錯誤原因。如 簽名失敗、參數(shù)格式校驗(yàn)錯誤

以下字段在returnCode為SUCCESS的時候有返回

字段名變量名必填類型示例值描述
服務(wù)商的APPIDappid是String(32)wxd678efh567hg6787服務(wù)商商戶的APPID
商戶號mch_id是String(32)1230000109微信支付分配的商戶號
小程序的APPIDsub_appid是String(32)wx8888888888888888微信分配的小程序ID
子商戶號sub_mch_id是String(32)1900000109微信支付分配的子商戶號
隨機(jī)字符串nonce_str是String(32)5K8264ILTKCH16CQ2502SI8ZNMTM67VS隨機(jī)字符串，不長于32位
簽名sign是String(32)C380BEC2BFD727A4B6845133519F3AD6簽名，驗(yàn)證簽名算法
業(yè)務(wù)結(jié)果result_code是String(16)SUCCESSSUCCESS/FAIL
業(yè)務(wù)結(jié)果描述result_msg是String(32)OK對于業(yè)務(wù)執(zhí)行的詳細(xì)描述
錯誤代碼err_code否String(32)SYSTEMERROR詳細(xì)參見下文錯誤列表
錯誤代碼描述err_code_des否String(128)系統(tǒng)錯誤結(jié)果信息描述

錯誤碼

名稱描述原因解決方案
ORDERPAID訂單已支付訂單已支付，不能發(fā)起關(guān)單訂單已支付，不能發(fā)起關(guān)單，請當(dāng)作已支付的正常交易
SYSTEMERROR系統(tǒng)錯誤系統(tǒng)錯誤系統(tǒng)異常，請重新調(diào)用該API
ORDERCLOSED訂單已關(guān)閉訂單已關(guān)閉，無法重復(fù)關(guān)閉訂單已關(guān)閉，無需繼續(xù)調(diào)用
SIGNERROR簽名錯誤參數(shù)簽名結(jié)果不正確請檢查簽名參數(shù)和方法是否都符合簽名算法要求
REQUIRE_POST_METHOD請使用post方法未使用post傳遞參數(shù)請檢查請求參數(shù)是否通過post方法提交
XML_FORMAT_ERRORXML格式錯誤XML格式錯誤請檢查XML參數(shù)格式是否正確


以上內(nèi)容是否對您有幫助：
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號