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

同步服務(wù)訂單信息API

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


由于收款商戶進(jìn)行的某些“線下操作”會導(dǎo)致微信支付側(cè)的訂單狀態(tài)與實際情況不符。例如，用戶通過線下付款的方式已經(jīng)完成支付，而微信支付側(cè)并未支付成功，此時可能導(dǎo)致用戶重復(fù)支付。因此商戶需要通過訂單同步接口將訂單狀態(tài)同步給微信支付，修改訂單在微信支付系統(tǒng)中的狀態(tài)。

接口說明

適用對象：直連商戶

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

請求方式：POST

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

前提條件：同步商戶渠道收款成功信息時，即場景類型=“Order_Paid”，訂單的狀態(tài)需為[MCH_COMPLETE:商戶完結(jié)訂單]


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

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

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


請求參數(shù)

參數(shù)名 變量 類型[長度限制] 必填 描述
商戶服務(wù)訂單號 out_order_no string[1,32] 是 path 商戶系統(tǒng)內(nèi)部訂單號（不是交易單號），要求此參數(shù)只能由數(shù)字、大小寫字母_-|*組成，且在同一個商戶號下唯一，詳見「商戶訂單號」，需要和創(chuàng)建訂單的商戶服務(wù)訂單號一致。
示例值：1234323JKHDFE1243252
公眾賬號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
場景類型 type string[1,32] 是 body 場景類型為“Order_Paid”，字符串表示“訂單收款成功” 。
示例值：Order_Paid
+ 內(nèi)容信息詳情 detail ?object 否 body 場景類型為Order_Paid時，為必填項。
參數(shù)名 變量 類型[長度限制] 必填 描述
收款成功時間 paid_time string[1,14] 是 支付成功時間，支持兩種格式：yyyyMMddHHmmss和yyyyMMdd

  1. ● 傳入20091225091010表示2009年12月25日9點(diǎn)10分10秒。
  2. ● 傳入20091225默認(rèn)時間為2009年12月25日0點(diǎn)0分0秒。

用戶通過其他方式付款成功的實際時間需滿足條件：服務(wù)開始時間＜調(diào)用商戶完結(jié)訂單接口的時間＜用戶通過其他方式付款成功的實際時間≤商戶調(diào)用支付分訂單同步接口的時間。
【服務(wù)開始時間】
1、當(dāng)完結(jié)訂單有填寫【實際服務(wù)開始時間】時，【服務(wù)開始時間】=完結(jié)訂單【實際服務(wù)開始時間】。
2、當(dāng)完結(jié)訂單未填寫【實際服務(wù)開始時間】時，【服務(wù)開始時間】=創(chuàng)建訂單【服務(wù)開始時間】
場景類型為Order_Paid時，必填。
支持兩種格式：yyyyMMddHHmmss和yyyyMMdd
● 傳入20091225091010表示2009年12月25日9點(diǎn)10分10秒。
● 傳入20091225表示時間為2009年12月25日23點(diǎn)59分59秒。
注意：微信支付分會根據(jù)此時間更新用戶側(cè)的守約記錄、負(fù)面記錄信息；因此請務(wù)必如實填寫用戶實際付款成功時間，以免造成不必要的客訴。
示例值：20091225091210

請求示例


{
  "appid": "wxd678efh567hg6787",
  "service_id": "500001",
  "type": "Order_Paid",
  "detail": {
    "paid_time": "20091225091210"
  }
}

    
｛
JAVA示例代碼
｝

返回參數(shù)

參數(shù)名 變量 類型[長度限制] 必填 描述
公眾賬號ID appid string[1,32] 是 調(diào)用接口提交的公眾賬號ID。
示例值：wxd678efh567hg6787
商戶號 mchid string[1,32] 是 調(diào)用接口提交的商戶號。
示例值：1230000109
商戶服務(wù)訂單號 out_order_no string[1,32] 是 調(diào)用接口提交的商戶服務(wù)訂單號。
示例值：1234323JKHDFE1243252
服務(wù)ID service_id string[1,32] 是 調(diào)用該接口提交的服務(wù)ID。
示例值：500001
服務(wù)信息 service_introduction string[1,20] 是 服務(wù)信息，用于介紹本訂單所提供的服務(wù)。
示例值：某某酒店
用戶標(biāo)識 openid string[1,128] 是 微信用戶在商戶對應(yīng)appid下的唯一標(biāo)識。
示例值：oUpF8uMuAJO_M2pxb1Q9zNjWeS6o
服務(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)項目金額之和-后付費(fèi)商戶優(yōu)惠項目金額之和，且小于等于訂單風(fēng)險金額。取消訂單時，該字段必須為0。
示例值：40000
+后付費(fèi)項目 post_payments array 否 后付費(fèi)項目列表，最多包含100條付費(fèi)項目。
參數(shù)名 變量 類型[長度限制] 必填 描述
付費(fèi)項目名稱 name string[1,20] 否 不超過20個字符，超出報錯處理。
示例值：就餐費(fèi)用, 服務(wù)費(fèi)
金額 amount int64 否

此付費(fèi)項目總金額，大于等于0，單位為分，等于0時代表不需要扣費(fèi)，只能為整數(shù)，詳見支付金額。

如果填寫了“付費(fèi)項目名稱”，則amount或description必須填寫其一，或都填。
示例值：40000
計費(fèi)說明 description string[1,30] 否 描述計費(fèi)規(guī)則，不超過30個字符，超出報錯處理。
示例值：就餐人均100元，服務(wù)費(fèi)：100/小時
付費(fèi)數(shù)量 count uint64 否 付費(fèi)項目的數(shù)量。
示例值：4
+后付費(fèi)商戶優(yōu)惠 post_discounts array 否 后付費(fèi)商戶優(yōu)惠，最多包含30條付費(fèi)項目。
參數(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)惠金額，只能為整數(shù)，詳見支付金額。
示例值：100
+訂單風(fēng)險金 risk_fund object 否 訂單風(fēng)險金信息
參數(shù)名 變量 類型[長度限制] 必填 描述
風(fēng)險金名稱 name string[1,64] 是 枚舉值：
【先免模式】（評估不通過可交押金）可填名稱為
DEPOSIT：押金
ADVANCE：預(yù)付款
CASH_DEPOSIT：保證金
【先享模式】（評估不通過不可使用服務(wù)）可填名稱為
ESTIMATE_ORDER_COST：預(yù)估訂單費(fèi)用
示例值：ESTIMATE_ORDER_COST
風(fēng)險金額 amount int64 是 1、數(shù)字，必須>0（單位分）。
2、風(fēng)險金額≤每個服務(wù)ID的風(fēng)險金額上限。
3、當(dāng)商戶優(yōu)惠字段為空時，付費(fèi)項目總金額≤服務(wù)ID的風(fēng)險金額上限 （未填寫金額的付費(fèi)項目，視為該付費(fèi)項目金額為0）。
示例值：10000
風(fēng)險說明 description string[1,30] 否 文字，不超過30個字。
示例值：就餐的預(yù)估費(fèi)用
+服務(wù)時間段 time_range object 否 服務(wù)時間范圍
參數(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ù)開始時間】。
【服務(wù)開始時間】不能早于調(diào)用接口時間。
根據(jù)傳入時間精準(zhǔn)度進(jìn)行校驗
1、若傳入時間精準(zhǔn)到秒，則校驗精準(zhǔn)到秒。
2、若傳入時間精準(zhǔn)到日，則校驗精準(zhǔn)到日。
示例值：20091225091010
服務(wù)開始時間備注 start_time_remark string[1,20] 否 服務(wù)開始時間備注說明。
1、服務(wù)開始時間有填時，可填寫服務(wù)開始時間備注，不超過20個字符，超出報錯處理。
示例值：開始租借日期
服務(wù)結(jié)束時間 end_time string[1,14] 否 用戶端展示用途，支持兩種格式：yyyyMMddHHmmss和yyyyMMdd
  1. ● 傳入20091225091010表示2009年12月25日9點(diǎn)10分10秒。
  2. ● 傳入20091225默認(rèn)時間為2009年12月25日。
根據(jù)傳入時間精準(zhǔn)度進(jìn)行校驗
1、若傳入時間精準(zhǔn)到秒，則校驗精準(zhǔn)到秒。
2、若傳入時間精準(zhǔn)到日，則校驗精準(zhǔn)到日。
示例值：20091225121010
服務(wù)結(jié)束時間備注 end_time_remark string[1,20] 否 服務(wù)結(jié)束時間備注說明，不超過20個字符，超出報錯處理。
1、服務(wù)結(jié)束時間有填時，可填寫服務(wù)結(jié)束時間備注
示例值：結(jié)束租借日期
+服務(wù)位置 location object 否 服務(wù)使用信息
參數(shù)名 變量 類型[長度限制] 必填 描述
服務(wù)開始地點(diǎn) start_location string[1,50] 否 開始使用服務(wù)的地點(diǎn)，不超過50個字符，超出報錯處理。
示例值：嗨客時尚主題展餐廳
服務(wù)結(jié)束位置 end_location string[1,50] 否 結(jié)束使用服務(wù)的地點(diǎn)，不超過50個字符，超出報錯處理。
示例值：嗨客時尚主題展餐廳
商戶數(shù)據(jù)包 attach string[1,256] 否 商戶數(shù)據(jù)包，可存放本訂單所需信息，需要先urlencode后傳入，總長度不大于256字符，超出報錯處理。
示例值：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 否 收款信息
參數(shù)名 變量 類型[長度限制] 必填 描述
收款狀態(tài) state string[1,32] 是 USER_PAYING：待支付
USER_PAID：已支付
示例值：USER_PAID
總收款金額 total_amount int64 否 總金額，大于等于0的數(shù)字，單位為分，只能為整數(shù)，詳見支付金額。
此參數(shù)需滿足：總金額=付費(fèi)項目金額之和-商戶優(yōu)惠項目金額之和，且小于等于訂單風(fēng)險金額 。未使用服務(wù)、取消訂單時，該字段必須為0。
示例值：50000
待收金額 paying_amount int64 否 等待用戶付款金額，只能為整數(shù)，詳見支付金額。
示例值：40000
已收金額 paid_amount int64 否 用戶已付款的金額，只能為整數(shù)，詳見支付金額。
示例值：10000
+收款明細(xì)列表 details array 否 收款明細(xì)列表
參數(shù)名 變量 類型[長度限制] 必填 描述
單筆收款金額 amount int64 否 單筆收款動作的金額，只能為整數(shù)，詳見支付金額。
示例值：10000
收款成功渠道 paid_type string[1,32] 否 NEWTON：微信支付分
MCH：商戶渠道
示例值：NEWTON
收款成功時間 paid_time string[1,14] 否 支付成功時間，支持兩種格式:yyyyMMddHHmmss和yyyyMMdd
  1. ● 傳入20091225091010表示2009年12月25日9點(diǎn)10分10秒。
  2. ● 傳入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": "某某酒店",
  "openid": "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o",
  "state": "CREATED",
  "state_description": "MCH_COMPLETE",
  "total_amount": 3900,
  "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
    }
  ],
  "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",
  "notify_url": "https://api.test.com",
  "order_id": "15646546545165651651",
  "need_collection": true,
  "collection": {
    "state": "USER_PAID",
    "total_amount": 3900,
    "paying_amount": 0,
    "paid_amount": 3900,
    "details": [
      {
        "amount": 10000,
        "paid_type": "NEWTON",
        "paid_time": "20091225091210",
        "transaction_id ": "15646546545165651651"
      }
    ]
  }
}
                                

    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)無需操作

版本說明

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

技術(shù)咨詢

文檔反饋