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

修改訂單金額API

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


完結訂單總金額與實際金額不符時，可通過該接口修改訂單金額。
例如：充電寶場景，由于機器計費問題導致商戶完結訂單時扣除用戶99元，用戶客訴成功后，商戶需要按照實際的消費金額（如10元）扣費，當服務訂單支付狀態(tài)處于“待支付”時，商戶可使用此能力修改訂單金額。

注意：

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

? 修改次數>=1，第n次修改后金額 <第n-1次修改后金額

接口說明

適用對象：直連商戶

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

請求方式：POST

接口規(guī)則：http://www.tg885.com/wiki/doc/apiv3/wechatpay/wechatpay-1.shtml

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


path 指該參數為路徑參數

query 指該參數需在請求URL傳參

body 指該參數需在請求JSON傳參


請求參數

參數名 變量 類型[長度限制] 必填 描述
商戶服務訂單號 out_order_no string[1,32] 是 path 商戶系統(tǒng)內部訂單號（不是交易單號），與創(chuàng)建訂單時一致。
示例值：1234323JKHDFE1243252
公眾賬號ID appid string[1,32] 是 body 微信公眾平臺分配的與傳入的商戶號建立了支付綁定關系的appid，可在公眾平臺查看綁定關系。
此參數需在本系統(tǒng)先進行配置，并與創(chuàng)建訂單時的appid保持一致。
示例值：wxd678efh567hg6787
服務ID service_id string[1,32] 是 body 該服務ID有本接口對應產品的權限，需要與創(chuàng)建訂單時保持一致。
示例值：500001
+后付費項目 post_payments array 是 body后付費項目列表，最多包含100條付費項目。
參數名 變量 類型[長度限制] 必填 描述
付費項目名稱 name string[1,20] 是 付費項目名稱不能重復，不超過20個字符，超出報錯處理。
示例值：就餐費用, 服務費
金額 amount int64 是 此付費項目總金額，大于等于0，單位為分，等于0時代表不需要扣費，只能為整數，詳見支付金額。
示例值：40000
計費說明 description string[1,30] 否 描述計費規(guī)則，不超過30個字符，超出報錯處理。
示例值：就餐人均100元，服務費：100/小時
付費數量 count uint32 否 付費項目的數量。
特殊規(guī)則：數量限制100，不填時默認1
示例值：4
+后付費商戶優(yōu)惠 post_discounts array 否 body后付費商戶優(yōu)惠列表，最多包含30條商戶優(yōu)惠。
如果傳入，用戶側則顯示此參數。
參數名 變量 類型[長度限制] 必填 描述
優(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)惠金額；單位為分，只能為整數，詳見支付金額。
示例值：100
優(yōu)惠數量 count uint32 否 優(yōu)惠的數量。
特殊規(guī)則：數量限制100，不填時默認1。
示例值：2
總金額 total_amount int64 是 body總金額，單位為分，不能超過完結訂單時候的總金額，只能為整數，詳見支付金額。此參數需滿足：總金額 =（修改后付費項目1…+修改后完結付費項目n）-（修改 后付費商戶優(yōu)惠項目1…+修改后付費商戶優(yōu)惠項目n）
示例值：50000
修改原因 reason string[1,50] 是 body按照字符計算，超過長度報錯處理。
示例值：用戶投訴

請求示例


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


    
｛
JAVA示例代碼
｝

返回參數

參數名 變量 類型[長度限制] 必填 描述
公眾賬號ID appid string[1,32] 是 調用接口提交的公眾賬號ID。
示例值：wxd678efh567hg6787
商戶號 mchid string[1,32] 是 調用接口提交的商戶號。
示例值：1230000109
服務ID service_id string[1,32] 是 調用該接口提交的服務ID。
示例值：500001
商戶服務訂單號 out_order_no string[1,32] 是 調用接口提交的商戶服務訂單號。
示例值：1234323JKHDFE1243252
服務信息 service_introduction string[1,20] 是 服務信息用于介紹本訂單所提供的服務，當參數長度超過20個字符時，報錯處理。
示例值：某某酒店
服務訂單狀態(tài) state string[1,32] 是 表示當前單據狀態(tài)。
枚舉值：
CREATED：商戶已創(chuàng)建服務訂單
DOING：服務訂單進行中
DONE：服務訂單完成
REVOKED：商戶取消服務訂單?
EXPIRED：服務訂單已失效，"商戶已創(chuàng)建服務訂單"狀態(tài)超過30天未變動，則訂單失效
示例值：CREATED
訂單狀態(tài)說明 state_description string[1,32] 否 對服務訂單"進行中"狀態(tài)的附加說明。
USER_CONFIRM：用戶確認
MCH_COMPLETE：商戶完結
示例值：MCH_COMPLETE
商戶收款總金額 total_amount int64 否 總金額，大于等于0的數字，單位為分，只能為整數，詳見支付金額。
此參數需滿足：總金額=修改后付費項目金額之和-修改后付費商戶優(yōu)惠項目金額之和，且小于等于訂單風險金額。
示例值：40000
+后付費項目 post_payments

array

 是 后付費項目列表，最多包含100條付費項目。
參數名 變量 類型[長度限制] 必填 描述
付費項目名稱 name string[1,20] 是 當參數長度超過20個字符時，報錯處理。
示例值：就餐費用, 服務費
金額 amount int64 是 此付費項目總金額，大于等于0，單位為分，等于0時代表不需要扣費。
示例值：40000
計費說明 description string[1,30] 否 描述計費規(guī)則，當參數長度超過30個字符時，報錯處理。
示例值：就餐人均100元，服務費：100/小時
付費數量 count uint32 否 付費項目的數量。
示例值：4
+后付費商戶優(yōu)惠 post_discounts

array

 否 后付費商戶優(yōu)惠，最多包含30條付費項目。
如果傳入，用戶側則顯示此參數。
參數名 變量 類型[長度限制] 必填 描述
優(yōu)惠名稱 name string[1,20] 否 優(yōu)惠名稱說明。
示例值：滿20減1元
優(yōu)惠說明 description string[1,30] 否 優(yōu)惠使用條件說明。
如果填寫了name（優(yōu)惠名稱）和description（優(yōu)惠說明）其中一個字段內容，則另一個字段也必須填寫。
示例值：不與其他優(yōu)惠疊加
優(yōu)惠金額 amount int64 條件選填 優(yōu)惠金額
示例值：100
優(yōu)惠數量 count uint32 否 優(yōu)惠的數量。
特殊規(guī)則：數量限制100，不填時默認1。
示例值：2
+訂單風險金 risk_fund

object

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

object

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

object

 否 服務位置信息。
如果傳入，用戶側則顯示此參數。
參數名 變量 類型[長度限制] 必填 描述
服務開始地點 start_location string[1,50] 否 開始使用服務的地點，不超過50個字符，超出報錯處理。
示例值：嗨客時尚主題展餐廳
服務結束位置 end_location string[1,50] 否 結束使用服務的地點，不超過50個字符，超出報錯處理。
示例值：嗨客時尚主題展餐廳
商戶數據包 attach string[1,256] 否 商戶數據包可存放本訂單所需信息，需要先urlencode后傳入。
當商戶數據包總長度超出256字符時，報錯處理。商戶接收回包是根據場景，決定是否需要做安全過濾(XSS/CSRF)。
示例值：Easdfowealsdkjfnlaksjdlfkwqoi&wl3l2sald
商戶回調地址 notify_url string[1,255] 否 商戶接收用戶確認訂單和扣款成功回調通知的地址。
示例值：https://api.test.com
微信支付服務訂單號 order_id string[1,64] 否 微信支付服務訂單號，每個微信支付服務訂單號與商戶號下對應的商戶服務訂單號一一對應。
示例值：15646546545165651651
是否需要收款 need_collection bool 否 true：微信支付分代收款
false：無需微信支付分代收款
示例值：true
+收款信息 collection object 否 服務使用信息
參數名 變量 類型[長度限制] 必填 描述
收款狀態(tài) state string[1,32] 是 USER_PAYING：待支付
USER_PAID：已支付
示例值：USER_PAID
總收款金額 total_amount int64 否 總金額，大于等于0的數字，單位為分，只能為整數，詳見支付金額。
此參數需滿足：總金額=付費項目金額之和-商戶優(yōu)惠項目金額之和，且小于等于訂單風險金額 。未使用服務、取消訂單時，該字段必須為0。
示例值：50000
待收金額 paying_amount int64 否 等待用戶付款金額，只能為整數，詳見支付金額。
示例值：40000
已收金額 paid_amount int64 否 用戶已付款的金額，只能為整數，詳見支付金額。
示例值：10000
+收款明細列表 details array 否 收款明細列表
參數名 變量 類型[長度限制] 必填 描述
收款序號 seq uint64 否 從1開始遞增
示例值：1
單筆收款金額 amount int64 否 單筆收款動作的金額，只能為整數，詳見支付金額。
示例值：10000
收款成功渠道 paid_type string[1,32] 否 NEWTON：微信支付分
MCH：商戶渠道
示例值：NEWTON
收款成功時間 paid_time string[1,14] 否 支付成功時間，支持兩種格式:yyyyMMddHHmmss和yyyyMMdd
  1. ● 傳入20091225091010表示2009年12月25日9點10分10秒
  2. ● 傳入20091225默認時間為2009年12月25日0點0分0秒
示例值：20091225091210
微信支付交易單號 transaction_id string[1,200] 否 結單交易單號，等于普通支付接口中的transaction_id，可以使用該訂單號在APP支付->API列表->查詢訂單、申請退款。只有單據狀態(tài)為USER_PAID，且收款成功渠道為支付分渠道，收款金額大于0，才會返回結單交易單號。
示例值：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": "就餐費用服務費",
      "amount": 2000
    }
  ],
  "risk_fund": {
    "name": "ESTIMATE_ORDER_COST",
    "amount": 10000,
    "description": "就餐的預估費用"
  },
  "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)問題，請使用相同參數稍后重新調用
400 PARAM_ERROR 參數錯誤 根據錯誤提示，傳入正確參數
403 NO_AUTH 商戶信息不合法 登錄商戶平臺核對，傳入正確信息
429 FREQUENCY_LIMITED 頻率超限 請求量不要超過接口調用頻率限制
400 INVALID_REQUEST 請求參數符合參數格式，但不符合業(yè)務規(guī)則 請確認相同單號是否使用了不同的參數
404 ORDER_NOT_?EXIST 訂單不存在 確認入參，傳入正確單據
400 INVALID_ORDER_STATE 單據狀態(tài)錯誤 確認操作是否符合流程
400 ORDER_CANCELED 單據已取消 當前狀態(tài)無需操作
400 ORDER_DONE 訂單已完成 當前狀態(tài)無需操作

版本說明

關閉
V1.3
2020.03.05
1. 服務訂單狀態(tài)，枚舉值：EXPIRED “狀態(tài)超過1小時未變動，則訂單失效”調整為“ED 狀態(tài)超過30天未變動，則訂單失效”
V1.2
2019.12.27
1. 服務時間段新增時間備注字段

技術咨詢

文檔反饋