微信支付-開發(fā)者文檔

返回上一層文檔首頁 / 修改訂單金額API

修改訂單金額API

最新更新時間：2020.03.05 版本說明

完結(jié)訂單總金額與實(shí)際金額不符時，且當(dāng)服務(wù)訂單收款狀態(tài)處于“待支付（USER_PAYING）”時，商戶可通過該接口修改訂單金額。

注意：

? 若此筆訂單已收款成功，商戶直接使用退款能力，將差價(jià)退回用戶即可。

? 修改次數(shù)>=1，第n次修改后金額 <第n-1次修改后金額。

? 押金訂單的金額不支持修改。

特別注意：待支付（USER_PAYING）狀態(tài)下，當(dāng)用戶正在嘗試通過收銀臺主動支付訂單金額時，修改訂單金額API無法調(diào)用成功，可等待3min后重試

接口說明

適用對象：直連商戶

請求URL：https://api.mch.weixin.qq.com/v3/payscore/serviceorder/{out_order_no}/modify

請求方式：POST

前置條件：服務(wù)訂單支付狀態(tài)為待支付

path 指該參數(shù)為路徑參數(shù)

query 指該參數(shù)需在請求URL傳參

body 指該參數(shù)需在請求JSON傳參

請求參數(shù)

參數(shù)名

變量

類型[長度限制]

必填

描述

商戶服務(wù)訂單號

out_order_no

string[1,32]

是

path 商戶系統(tǒng)內(nèi)部訂單號（不是交易單號），與創(chuàng)建訂單時一致。
示例值：1234323JKHDFE1243252

應(yīng)用ID

appid

string[1,32]

是

body 微信公眾平臺分配的與傳入的商戶號建立了支付綁定關(guān)系的appid，可在公眾平臺查看綁定關(guān)系。
此參數(shù)需在本系統(tǒng)先進(jìn)行配置，并與創(chuàng)建訂單時的appid保持一致。
示例值：wxd678efh567hg6787

服務(wù)ID

service_id

string[1,32]

是

body 該服務(wù)ID有本接口對應(yīng)產(chǎn)品的權(quán)限，需要與創(chuàng)建訂單時保持一致。
示例值：500001

+后付費(fèi)項(xiàng)目

post_payments

array

是

body后付費(fèi)項(xiàng)目列表，最多包含100條付費(fèi)項(xiàng)目。

參數(shù)名	變量	類型[長度限制]	必填	描述
付費(fèi)項(xiàng)目名稱	name	string[1,20]	是	相同訂單號下不能出現(xiàn)相同的付費(fèi)項(xiàng)目名稱（付費(fèi)項(xiàng)目名稱為“商品信息”時除外，即可傳入多條“商品信息”），當(dāng)參數(shù)長度超過20個字符時，報(bào)錯處理。示例值：就餐費(fèi)用, 服務(wù)費(fèi)
金額	amount	int64	條件選填	此付費(fèi)項(xiàng)目總金額，大于等于0，單位為分，等于0時代表不需要扣費(fèi)，只能為整數(shù)。如果填寫了“付費(fèi)項(xiàng)目名稱”，則amount或description必須填寫其一，或都填。示例值：40000
計(jì)費(fèi)說明	description	string[1,30]	條件選填	描述計(jì)費(fèi)規(guī)則，不超過30個字符，超出報(bào)錯處理。如果填寫了“付費(fèi)項(xiàng)目名稱”，則amount或description必須填寫其一，或都填。示例值：就餐人均100元，服務(wù)費(fèi)：100/小時
付費(fèi)數(shù)量	count	int32	否	付費(fèi)項(xiàng)目的數(shù)量。特殊規(guī)則：數(shù)量限制100，不填時默認(rèn)1 示例值：4

+后付費(fèi)商戶優(yōu)惠

post_discounts

array

否

body后付費(fèi)商戶優(yōu)惠列表，最多包含30條商戶優(yōu)惠。
如果傳入，用戶側(cè)則顯示此參數(shù)。

參數(shù)名	變量	類型[長度限制]	必填	描述
優(yōu)惠名稱	name	string[1,20]	否	優(yōu)惠名稱說明；name和description若填寫，則必須同時填寫。示例值：滿20減1元
優(yōu)惠說明	description	string[1,30]	條件選填	優(yōu)惠使用條件說明。 name和description若填寫，則必須同時填寫。示例值：不與其他優(yōu)惠疊加
優(yōu)惠金額	amount	int64	條件選填	優(yōu)惠金額；單位為分，只能為整數(shù)，詳見支付金額。示例值：100
優(yōu)惠數(shù)量	count	int32	否	優(yōu)惠的數(shù)量。特殊規(guī)則：數(shù)量限制100，不填時默認(rèn)1。示例值：2

總金額

total_amount

int64

是

body總金額，單位為分，不能超過完結(jié)訂單時候的總金額，只能為整數(shù)，詳見支付金額。此參數(shù)需滿足：總金額 =（修改后付費(fèi)項(xiàng)目1…+修改后完結(jié)付費(fèi)項(xiàng)目n）-（修改后付費(fèi)商戶優(yōu)惠項(xiàng)目1…+修改后付費(fèi)商戶優(yōu)惠項(xiàng)目n）
示例值：50000

修改原因

reason

string[1,50]

是

body按照字符計(jì)算，超過長度報(bào)錯處理。
示例值：用戶投訴

請求示例

JSON


{
  "appid": "wxd678efh567hg6787",
  "service_id": "500001",
    "post_payments": [
    {
      "name": "就餐費(fèi)用服務(wù)費(fèi)",
      "amount": 4000,
      "description": "就餐人均100元服務(wù)費(fèi)：100/小時",
      "count": 1
    }
  ],
  "post_discounts":[
  {
    "name": "滿20減1元",
    "description": "不與其他優(yōu)惠疊加",
    "amount": 100
   }
  ],
  "total_amount": 2000,
  "reason": "用戶投訴"
}

    
｛
JAVA示例代碼
｝

返回參數(shù)

參數(shù)名

變量

類型[長度限制]

必填

描述

應(yīng)用ID

appid

string[1,32]

是

調(diào)用接口提交的公眾賬號ID。
示例值：wxd678efh567hg6787

商戶號

mchid

string[1,32]

是

調(diào)用接口提交的商戶號。
示例值：1230000109

服務(wù)ID

service_id

string[1,32]

是

調(diào)用該接口提交的服務(wù)ID。
示例值：500001

商戶服務(wù)訂單號

out_order_no

string[1,32]

是

調(diào)用接口提交的商戶服務(wù)訂單號。
示例值：1234323JKHDFE1243252

服務(wù)信息

service_introduction

string[1,20]

是

服務(wù)信息用于介紹本訂單所提供的服務(wù)，當(dāng)參數(shù)長度超過20個字符時，報(bào)錯處理。
示例值：某某酒店

服務(wù)訂單狀態(tài)

state

string[1,32]

是

表示當(dāng)前單據(jù)狀態(tài)。
枚舉值：
CREATED：商戶已創(chuàng)建服務(wù)訂單
DOING：服務(wù)訂單進(jìn)行中
DONE：服務(wù)訂單完成
REVOKED：商戶取消服務(wù)訂單?
EXPIRED：服務(wù)訂單已失效，"商戶已創(chuàng)建服務(wù)訂單"狀態(tài)超過30天未變動，則訂單失效
示例值：CREATED

訂單狀態(tài)說明

state_description

string[1,32]

否

對服務(wù)訂單"進(jìn)行中"狀態(tài)的附加說明。
USER_CONFIRM：用戶確認(rèn)
MCH_COMPLETE：商戶完結(jié)
示例值：MCH_COMPLETE

商戶收款總金額

total_amount

int64

否

總金額，大于等于0的數(shù)字，單位為分，只能為整數(shù)，詳見支付金額。
此參數(shù)需滿足：總金額=修改后付費(fèi)項(xiàng)目金額之和-修改后付費(fèi)商戶優(yōu)惠項(xiàng)目金額之和，且小于等于訂單風(fēng)險(xiǎn)金額。
示例值：40000

+后付費(fèi)項(xiàng)目

post_payments

array

是

后付費(fèi)項(xiàng)目列表，最多包含100條付費(fèi)項(xiàng)目。

參數(shù)名	變量	類型[長度限制]	必填	描述
付費(fèi)項(xiàng)目名稱	name	string[1,20]	是	相同訂單號下不能出現(xiàn)相同的付費(fèi)項(xiàng)目名稱（付費(fèi)項(xiàng)目名稱為“商品信息”時除外，即可傳入多條“商品信息”），當(dāng)參數(shù)長度超過20個字符時，報(bào)錯處理。示例值：就餐費(fèi)用, 服務(wù)費(fèi)
金額	amount	int64	條件選填	此付費(fèi)項(xiàng)目總金額，大于等于0，單位為分，等于0時代表不需要扣費(fèi)，只能為整數(shù)。如果填寫了“付費(fèi)項(xiàng)目名稱”，則amount或description必須填寫其一，或都填。示例值：40000
計(jì)費(fèi)說明	description	string[1,30]	條件選填	描述計(jì)費(fèi)規(guī)則，不超過30個字符，超出報(bào)錯處理。如果填寫了“付費(fèi)項(xiàng)目名稱”，則amount或description必須填寫其一，或都填。示例值：就餐人均100元，服務(wù)費(fèi)：100/小時
付費(fèi)數(shù)量	count	int32	否	付費(fèi)項(xiàng)目的數(shù)量。示例值：4

+后付費(fèi)商戶優(yōu)惠

post_discounts

array

否

后付費(fèi)商戶優(yōu)惠，最多包含30條付費(fèi)項(xiàng)目。
如果傳入，用戶側(cè)則顯示此參數(shù)。

參數(shù)名	變量	類型[長度限制]	必填	描述
優(yōu)惠名稱	name	string[1,20]	否	優(yōu)惠名稱說明。示例值：滿20減1元
優(yōu)惠說明	description	string[1,30]	否	優(yōu)惠使用條件說明。如果填寫了name（優(yōu)惠名稱）和description（優(yōu)惠說明）其中一個字段內(nèi)容，則另一個字段也必須填寫。示例值：不與其他優(yōu)惠疊加
優(yōu)惠金額	amount	int64	條件選填	優(yōu)惠金額示例值：100
優(yōu)惠數(shù)量	count	int32	否	優(yōu)惠的數(shù)量。特殊規(guī)則：數(shù)量限制100，不填時默認(rèn)1。示例值：2

+訂單風(fēng)險(xiǎn)金

risk_fund

object

是

訂單風(fēng)險(xiǎn)金信息。
如果傳入，用戶側(cè)則顯示此參數(shù)。

參數(shù)名	變量	類型[長度限制]	必填	描述
風(fēng)險(xiǎn)金名稱	name	string[1,64]	是	枚舉值：【先免模式】（評估不通過可交押金）可填名稱為 DEPOSIT：押金 ADVANCE：預(yù)付款 CASH_DEPOSIT：保證金【先享模式】（評估不通過不可使用服務(wù)）可填名稱為 ESTIMATE_ORDER_COST：預(yù)估訂單費(fèi)用示例值：ESTIMATE_ORDER_COST
風(fēng)險(xiǎn)金額	amount	int64	是	1、數(shù)字，必須>0（單位分）。 2、風(fēng)險(xiǎn)金額≤每個服務(wù)ID的風(fēng)險(xiǎn)金額上限。 3、當(dāng)商戶優(yōu)惠字段為空時，付費(fèi)項(xiàng)目總金額≤服務(wù)ID的風(fēng)險(xiǎn)金額上限（未填寫金額的付費(fèi)項(xiàng)目，視為該付費(fèi)項(xiàng)目金額為0）。示例值：10000
風(fēng)險(xiǎn)說明	description	string[1,30]	否	文字，不超過30個字。示例值：就餐的預(yù)估費(fèi)用

+服務(wù)時間段

time_range

object

否

服務(wù)時間范圍。
如果傳入，用戶側(cè)則顯示此參數(shù)。

參數(shù)名	變量	類型[長度限制]	必填	描述
服務(wù)開始時間	start_time	string[1,14]	否	用戶端展示用途。用戶下單時確認(rèn)的服務(wù)開始時間（比如用戶今天下單，明天開始接受服務(wù)，這里指的是明天的服務(wù)開始時間）。支持三種格式：yyyyMMddHHmmss、yyyyMMdd和 OnAccept ● 傳入20091225091010表示2009年12月25日9點(diǎn)10分10秒。 ● 傳入20091225默認(rèn)時間為2009年12月25日。 ● 傳入OnAccept表示用戶確認(rèn)訂單成功時間為【服務(wù)開始時間】。根據(jù)傳入時間精準(zhǔn)度進(jìn)行校驗(yàn) 1）若傳入時間精準(zhǔn)到秒，則校驗(yàn)精準(zhǔn)到秒。 2）若傳入時間精準(zhǔn)到日，則校驗(yàn)精準(zhǔn)到日。示例值：20091225091010
服務(wù)開始時間備注	start_time_remark	string[1,20]	否	服務(wù)開始時間備注說明，服務(wù)開始時間有填時，可填寫服務(wù)開始時間備注，不超過20個字符，超出報(bào)錯處理。示例值：開始租借日期
服務(wù)結(jié)束時間	end_time	string[1,14]	否	用戶端展示用途，支持兩種格式：yyyyMMddHHmmss和yyyyMMdd ● 傳入20091225091010表示2009年12月25日9點(diǎn)10分10秒。 ● 傳入20091225默認(rèn)時間為2009年12月25日。根據(jù)傳入時間精準(zhǔn)度進(jìn)行校驗(yàn) 1、若傳入時間精準(zhǔn)到秒，則校驗(yàn)精準(zhǔn)到秒。 2、若傳入時間精準(zhǔn)到日，則校驗(yàn)精準(zhǔn)到日。示例值：20091225121010
服務(wù)結(jié)束時間備注	end_time_remark	string[1,20]	否	服務(wù)結(jié)束時間備注說明，服務(wù)結(jié)束時間有填時，可填寫服務(wù)結(jié)束時間備注，不超過20個字符，超出報(bào)錯處理。示例值：結(jié)束租借日期

+服務(wù)位置

location

object

否

服務(wù)位置信息。
如果傳入，用戶側(cè)則顯示此參數(shù)。

參數(shù)名	變量	類型[長度限制]	必填	描述
服務(wù)開始地點(diǎn)	start_location	string[1,50]	否	開始使用服務(wù)的地點(diǎn)，不超過50個字符，超出報(bào)錯處理。示例值：嗨客時尚主題展餐廳
服務(wù)結(jié)束位置	end_location	string[1,50]	否	結(jié)束使用服務(wù)的地點(diǎn)，不超過50個字符，超出報(bào)錯處理。示例值：嗨客時尚主題展餐廳

商戶數(shù)據(jù)包

attach

string[1,256]

否

商戶數(shù)據(jù)包可存放本訂單所需信息，需要先urlencode后傳入。
當(dāng)商戶數(shù)據(jù)包總長度超出256字符時，報(bào)錯處理。商戶接收回包是根據(jù)場景，決定是否需要做安全過濾(XSS/CSRF)。
示例值：Easdfowealsdkjfnlaksjdlfkwqoi&wl3l2sald

商戶回調(diào)地址

notify_url

string[1,255]

否

商戶接收用戶確認(rèn)訂單和扣款成功回調(diào)通知的地址。
示例值：https://api.test.com

微信支付服務(wù)訂單號

order_id

string[1,64]

否

微信支付服務(wù)訂單號，每個微信支付服務(wù)訂單號與商戶號下對應(yīng)的商戶服務(wù)訂單號一一對應(yīng)。
示例值：15646546545165651651

是否需要收款

need_collection

bool

否

true：微信支付分代收款
false：無需微信支付分代收款
示例值：true

+收款信息

collection

object

否

服務(wù)使用信息

參數(shù)名

變量

類型[長度限制]

必填

描述

收款狀態(tài)

state

string[1,32]

是

USER_PAYING：待支付
USER_PAID：已支付
示例值：USER_PAID

總收款金額

total_amount

int64

否

總金額，大于等于0的數(shù)字，單位為分，只能為整數(shù)，詳見支付金額。
此參數(shù)需滿足：總金額=付費(fèi)項(xiàng)目金額之和-商戶優(yōu)惠項(xiàng)目金額之和，且小于等于訂單風(fēng)險(xiǎn)金額。未使用服務(wù)、取消訂單時，該字段必須為0。
示例值：50000

待收金額

paying_amount

int64

否

等待用戶付款金額，只能為整數(shù)，詳見支付金額。
示例值：40000

已收金額

paid_amount

int64

否

用戶已付款的金額，只能為整數(shù)，詳見支付金額。
示例值：10000

+收款明細(xì)列表

details

array

否

收款明細(xì)列表

參數(shù)名	變量	類型[長度限制]	必填	描述
收款序號	seq	int64	否	從1開始遞增示例值：1
單筆收款金額	amount	int64	否	單筆收款動作的金額，只能為整數(shù)，詳見支付金額。示例值：10000
收款成功渠道	paid_type	string[1,32]	否	NEWTON：微信支付分 MCH：商戶渠道示例值：NEWTON
收款成功時間	paid_time	string[1,14]	否	支付成功時間，支持兩種格式:yyyyMMddHHmmss和yyyyMMdd ● 傳入20091225091010表示2009年12月25日9點(diǎn)10分10秒 ● 傳入20091225默認(rèn)時間為2009年12月25日0點(diǎn)0分0秒示例值：20091225091210
微信支付交易單號	transaction_id	string[1,200]	否	結(jié)單交易單號，等于普通支付接口中的transaction_id，可以使用該訂單號在APP支付->API列表->查詢訂單、申請退款。只有單據(jù)狀態(tài)為USER_PAID，且收款成功渠道為支付分渠道，收款金額大于0，才會返回結(jié)單交易單號。示例值：15646546545165651651

返回示例

正常示例


{
  "appid": "wxd678efh567hg6787",
  "mchid": "1230000109",
  "service_id": "500001",
  "out_order_no": "1234323JKHDFE1243252",
  "service_introduction": "某某酒店",
  "state": "CREATED",
  "state_description": "MCH_COMPLETE",
  "total_amount": 2000,
  "post_payments": [
    {
      "name": "就餐費(fèi)用服務(wù)費(fèi)",
      "amount": 2000
    }
  ],
  "risk_fund": {
    "name": "ESTIMATE_ORDER_COST",
    "amount": 10000,
    "description": "就餐的預(yù)估費(fèi)用"
  },
  "time_range": {
    "start_time": "20091225091010",
    "end_time": "20091225121010"
  },
  "location": {
    "start_location": "嗨客時尚主題展餐廳",
    "end_location": "嗨客時尚主題展餐廳"
  },
  "attach": "Easdfowealsdkjfnlaksjdlfkwqoi&wl3l2sald",
  "order_id": "15646546545165651651",
  "need_collection": true,
  "collection": {
    "state": "USER_PAYING",
    "total_amount": 2000,
    "paying_amount": 2000,
    "paid_amount": 0,
    "details": [
      {}
    ]
  }
}


    http://2323weixin.qq.com

錯誤碼公共錯誤碼

狀態(tài)碼	錯誤碼	描述	解決方案
500	SYSTEM_ERROR	系統(tǒng)錯誤	5開頭的狀態(tài)碼都為系統(tǒng)問題，請使用相同參數(shù)稍后重新調(diào)用
400	PARAM_ERROR	參數(shù)錯誤	根據(jù)錯誤提示，傳入正確參數(shù)
403	NO_AUTH	商戶信息不合法	登錄商戶平臺核對，傳入正確信息
429	FREQUENCY_LIMITED	頻率超限	請求量不要超過接口調(diào)用頻率限制
400	INVALID_REQUEST	請求參數(shù)符合參數(shù)格式，但不符合業(yè)務(wù)規(guī)則	請確認(rèn)相同單號是否使用了不同的參數(shù)
404	ORDER_NOT_EXIST	訂單不存在	確認(rèn)入?yún)ⅲ瑐魅胝_單據(jù)
400	INVALID_ORDER_STATE	單據(jù)狀態(tài)錯誤	確認(rèn)操作是否符合流程
400	ORDER_CANCELED	單據(jù)已取消	當(dāng)前狀態(tài)無需操作
400	ORDER_DONE	訂單已完成	當(dāng)前狀態(tài)無需操作

常見問題更多QA

1、微信支付分通用化常見技術(shù)問題

视频一区二区三区自拍_千金肉奴隷1985未删减版在线观看_国产成人黄色视频在线播放_少女免费播放片高清在线观看_国产精品v欧美精品v

微信支付商戶平臺

修改訂單金額API

注意：

接口說明

請求參數(shù)

請求示例

返回參數(shù)

返回示例

錯誤碼公共錯誤碼