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

返回上一層文檔首頁 / 微信支付分 / 支付分通用接口 / 查詢支付分訂單API

查詢支付分訂單API

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

用于查詢單筆微信支付分訂單詳細(xì)信息。

接口說明

適用對象：直連商戶

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

請求方式：GET

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

前置條件：商戶下單已受理后

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

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

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

請求參數(shù)

參數(shù)名	變量	類型[長度限制]	必填	描述
商戶服務(wù)訂單號	out_order_no	string[1,32]	二選一	query 商戶系統(tǒng)內(nèi)部服務(wù)訂單號（不是交易單號），與創(chuàng)建訂單時一致示例值：1234323JKHDFE1243252
回跳查詢ID	query_id	string[1,64]	二選一	query 微信側(cè)回跳到商戶前端時用于查單的單據(jù)查詢id。詳見章節(jié)“小程序跳轉(zhuǎn)接口，回跳商戶接口”。商戶單號與回跳查詢id必填其中一個.不允許都填寫或都不填寫。示例值：15646546545165651651
服務(wù)ID	service_id	string[1,32]	是	query 該服務(wù)ID有本接口對應(yīng)產(chǎn)品的權(quán)限示例值：500001
公眾賬號ID	appid	string[1,32]	是	query 微信公眾平臺分配的與傳入的商戶號建立了支付綁定關(guān)系的appid，可在公眾平臺查看綁定關(guān)系，此參數(shù)需在本系統(tǒng)先進行配置。示例值：wxd678efh567hg6787

請求示例


URL: “https://api.mch.weixin.qq.com/v3/payscore/serviceorder?service_id=500001
             &out_order_no=8416518464133&appid=wxd678efh567hg6787” 

或 

URL: “https://api.mch.weixin.qq.com/v3/payscore/serviceorder?service_id=500001
             &query_id=brnbonve1465wq3q2&appid=wxd678efh567hg6787” ;


｛
JAVA示例代碼
｝

返回參數(shù)

參數(shù)名

變量

類型[長度限制]

必填

描述

公眾賬號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個字符時，報錯處理。
示例值：某某酒店

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

state

string[1,32]

是

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

訂單狀態(tài)說明

state_description

string[1,32]

否

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

商戶收款總金額

total_amount

int64

否

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

+后付費項目

post_payments

array

否

后付費項目列表，最多包含100條付費項目

參數(shù)名	變量	類型[長度限制]	必填	描述
付費項目名稱	name	string[1,20]	否	當(dāng)參數(shù)長度超過20個字符時，報錯處理示例值：就餐費用, 服務(wù)費
金額	amount	int64	否	此付費項目總金額，大于等于0，單位為分，等于0時代表不需要扣費如果填寫了“付費項目名稱”，則amount或description必須填寫其一，或都填。示例值：40000
計費說明	description	string[1,30]	否	描述計費規(guī)則，當(dāng)參數(shù)長度超過30個字符時，報錯處理示例值：就餐人均100元，服務(wù)費：100/小時
付費數(shù)量	count	uint32	否	付費項目的數(shù)量示例值：4

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

post_discounts

array

否

后付費商戶優(yōu)惠，最多包含30條付費項目

參數(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
付費數(shù)量	count	uint	否	付費項目的數(shù)量示例值：2

+訂單風(fēng)險金

risk_fund

object

否

訂單風(fēng)險金信息

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

+服務(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點10分10秒。 ● 傳入20091225默認(rèn)時間為2009年12月25日。 ● 傳入OnAccept表示用戶確認(rèn)訂單成功時間為【服務(wù)開始時間】。根據(jù)傳入時間精準(zhǔn)度進行校驗 1）若傳入時間精準(zhǔn)到秒，則校驗精準(zhǔn)到秒。 2）若傳入時間精準(zhǔn)到日，則校驗精準(zhǔn)到日。示例值：20091225091010
服務(wù)開始時間備注	start_time_remark	string[1,20]	否	服務(wù)開始時間備注說明，服務(wù)開始時間有填時，可填寫服務(wù)開始時間備注，不超過20個字符，超出報錯處理。示例值：開始租借日期
服務(wù)結(jié)束時間	end_time	string[1,14]	否	用戶端展示用途，支持兩種格式：yyyyMMddHHmmss和yyyyMMdd ● 傳入20091225091010表示2009年12月25日9點10分10秒。 ● 傳入20091225默認(rèn)時間為2009年12月25日。根據(jù)傳入時間精準(zhǔn)度進行校驗 1、若傳入時間精準(zhǔn)到秒，則校驗精準(zhǔn)到秒。 2、若傳入時間精準(zhǔn)到日，則校驗精準(zhǔn)到日。示例值：20091225121010
服務(wù)結(jié)束時間備注	end_time_remark	string[1,20]	否	服務(wù)結(jié)束時間備注說明，服務(wù)結(jié)束時間有填時，可填寫服務(wù)結(jié)束時間備注，不超過20個字符，超出報錯處理。示例值：結(jié)束租借日期

+服務(wù)位置

location

object

否

服務(wù)使用信息

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

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

attach

string[1,256]

否

商戶數(shù)據(jù)包可存放本訂單所需信息，需要先urlencode后傳入。
當(dāng)商戶數(shù)據(jù)包總長度超出256字符時，報錯處理。商戶接收回包是根據(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

條件選填

是否需要收款，非0元完結(jié)后返回
true：微信支付分代收款
false：無需微信支付分代收款
示例值：true

+收款信息

collection

object

條件選填

收款信息，非0元完結(jié)后返回

參數(shù)名

變量

類型[長度限制]

必填

描述

收款狀態(tài)

state

string[1,32]

是

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

總收款金額

total_amount

int64

否

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

待收金額

paying_amount

int64

否

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

已收金額

paid_amount

int64

否

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

+收款明細(xì)列表

details

array

否

收款明細(xì)列表

參數(shù)名

變量

類型[長度限制]

必填

描述

收款序號

seq

int

否

從1開始遞增
示例值：1

單筆收款金額

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點10分10秒
2、傳入20091225默認(rèn)時間為2009年12月25日0點0分0秒

示例值：20091225091210

微信支付交易單號

transaction_id

string[1,200]

否

結(jié)單交易單號，等于普通支付接口中的transaction_id，可以使用該訂單號在APP支付->API列表->查詢訂單、申請退款。只有單據(jù)狀態(tài)為USER_PAID，且收款成功渠道為支付分渠道，收款金額大于0，才會返回結(jié)單交易單號。
示例值：15646546545165651651

+ 優(yōu)惠功能

promotion_detail

array

否

優(yōu)惠功能
注：針對2020年5月27日10:00:00以后完結(jié)的訂單生效

參數(shù)名

變量

類型[長度限制]

必填

描述

券ID

coupon_id

string[1,32]

是

券ID
示例值：123456

優(yōu)惠名稱

name

string[1,64]

否

優(yōu)惠名稱
示例值：單品優(yōu)惠-6

優(yōu)惠范圍

scope

string[1,12]

否

GLOBAL：全場代金券；
SINGLE：單品優(yōu)惠
示例值：GLOBAL

優(yōu)惠類型

type

string[1,12]

否

枚舉值：CASH：充值；
NOCASH：免充值。
示例值：CASH

優(yōu)惠券面額

amount

int

是

優(yōu)惠券面額
示例值：100

活動ID

stock_id

string[1,32]

否

活動ID，批次ID
示例值：activity_id

微信出資

wechatpay_contribute

int

否

微信出資
示例值：100

商戶出資

merchant_contribute

int64

否

商戶出資
示例值：100

其他出資

other_contribute

int64

否

其他出資
示例值：0

優(yōu)惠幣種

currency

string

否

CNY：人民幣，境內(nèi)商戶號僅支持人民幣
示例值：CNY

+ 單品列表

goods_detail

array

否

單品列表

參數(shù)名	變量	類型[長度限制]	必填	描述
商品編碼	goods_id	string[1,32]	是	商品編碼示例值：M1006
商品數(shù)量	quantity	uint32	否	商品數(shù)量示例值：1
商品價格	unit_price	int64	否	商品價格示例值：1
商品優(yōu)惠金額	discount_amount	int64	否	商品優(yōu)惠金額示例值：0
商品備注	goods_remark	string[1,128]	否	商品備注示例值：商品備注信息

用戶標(biāo)識

openid

string[1,128]

否

微信用戶在商戶對應(yīng)appid下的唯一標(biāo)識
示例值：oUpF8uMuAJO_M2pxb1Q9zNjWeS6o

返回示例

正常示例


{
  "appid": "wxd678efh567hg6787",
  "mchid": "1230000109",
  "service_id": "500001",
  "out_order_no": "1234323JKHDFE1243252",
  "service_introduction": "某某酒店",
  "state": "DOING",
  "state_description": "MCH_COMPLETE",
  "total_amount": 3900,
  "post_payments": [
    {
      "name": "就餐費用服務(wù)費",
      "amount": 4000,
      "description": "就餐人均100元服務(wù)費：100/小時",
      "count": 1
    }
  ],
  "post_discounts": [
    {
      "name": "滿20減1元",
      "description": "不與其他優(yōu)惠疊加",
      "amount": 100
    }
  ],
  "risk_fund": {
    "name": "ESTIMATE_ORDER_COST",
    "amount": 10000,
    "description": "就餐的預(yù)估費用"
  },
  "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": 3000,
    "paid_amount": 900,
    "details": [
      {
        "seq": 1,
        "amount": 900,
        "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)無需操作

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

微信支付商戶平臺

支付分通用文檔

查詢支付分訂單API

接口說明

請求參數(shù)

請求示例

返回參數(shù)

返回示例

錯誤碼公共錯誤碼

版本說明