# 1. 概述
接入微信支付分的商戶需在創(chuàng)建、完結(jié)、修改訂單金額時(shí),通過API接口中的post_payments參數(shù)回傳詳細(xì)的后付費(fèi)項(xiàng)目明細(xì)。該明細(xì)將在支付分訂單詳情頁(yè)面展示,減少用戶對(duì)訂單金額的疑問。
post_payments為數(shù)組類型參數(shù),該參數(shù)可包含多條“后付費(fèi)項(xiàng)目明細(xì)”,至少傳1條明細(xì),最多可傳100條明細(xì),每條“后付費(fèi)項(xiàng)目明細(xì)”包含name、amount、description、count四個(gè)參數(shù)。
# 2. 后付費(fèi)項(xiàng)目參數(shù)傳值要求
# 2.1 創(chuàng)建支付分訂單接口
智慧零售(無(wú)人設(shè)備)行業(yè)的商戶在創(chuàng)建支付分訂單時(shí),無(wú)需回傳post_payments【后付費(fèi)項(xiàng)目】參數(shù),用戶購(gòu)買的商品信息在完結(jié)接口進(jìn)行回傳,然后在支付分訂單明細(xì)中向用戶展示所購(gòu)商品收費(fèi)信息。
# 2.2 完結(jié)支付分訂單接口
當(dāng)服務(wù)結(jié)束后,商戶調(diào)用完結(jié)支付分訂單接口,需通過post_payments【后付費(fèi)項(xiàng)目】參數(shù)回傳訂單實(shí)際的商品信息,在智慧零售(無(wú)人設(shè)備)行業(yè)中,只允許回傳“商品信息”這1類付費(fèi)項(xiàng)目。
post_payments必須包含至少一筆“商品信息”的后付費(fèi)項(xiàng)目;若實(shí)際收費(fèi)中,用戶購(gòu)買了多個(gè)商品,請(qǐng)按照實(shí)際情況添加各“商品信息”的后付費(fèi)項(xiàng)目明細(xì)。
例如:如果用戶購(gòu)買了一個(gè)商品A,則只需回傳一筆“商品信息”的后付費(fèi)項(xiàng)目明細(xì),如果用戶至購(gòu)買了一個(gè)商品A,一個(gè)商品B,共兩樣商品,則需回傳兩筆“商品信息”的后付費(fèi)項(xiàng)目明細(xì),分別對(duì)應(yīng)商品A與商品B,詳見傳值示例。
post_payments參數(shù)傳值要求:
字段簡(jiǎn)稱 | 字段名 | 類型[長(zhǎng)度限制] | 是否必填 | 示例值 | 描述 | 傳值示例(購(gòu)買一個(gè)商品) | 傳值示例(購(gòu)買多個(gè)商品) |
---|---|---|---|---|---|---|---|
后付費(fèi)項(xiàng)目名稱 | name | string [1, 20] | 必填 | 首重費(fèi) | 付費(fèi)項(xiàng)目名稱,只可填寫“商品信息”四個(gè)字 | "post_payments" : [{"name" : "商品信息","amount" : 300,"description":"可樂","count":1}] | "post_payments" : [{"name" : "商品信息","amount" : 300,"description":"可樂","count":1},{"name" : "商品信息","amount" : 300,"description":"雪碧","count":1}] |
后付費(fèi)項(xiàng)目金額 | amount | int | 必填 | 300 | 付費(fèi)項(xiàng)目金額,單位為分 | "post_payments" : [{"name" : "商品信息","amount" : 300,"description":"可樂","count":1}] | "post_payments" : [{"name" : "商品信息","amount" : 300,"description":"可樂","count":1},{"name" : "商品信息","amount" : 300,"description":"雪碧","count":1}] |
后付費(fèi)項(xiàng)目說明 | description | string [1, 30] | 必填 | 可樂 | 商品名稱 | "post_payments" : [{"name" : "商品信息","amount" : 300,"description":"可樂","count":1}] | "post_payments" : [{"name" : "商品信息","amount" : 300,"description":"可樂","count":1},{"name" : "商品信息","amount" : 300,"description":"雪碧","count":1}] |
后付費(fèi)項(xiàng)目的數(shù)量 | count | int | 必填 | 1 | 商品數(shù)量 | "post_payments" : [{"name" : "商品信息","amount" : 300,"description":"可樂","count":1}] | "post_payments" : [{"name" : "商品信息","amount" : 300,"description":"可樂","count":1},{"name" : "商品信息","amount" : 300,"description":"雪碧","count":1}] |
后付費(fèi)項(xiàng)目明細(xì)在支付分訂單頁(yè)面的實(shí)際展示效果(以下兩種呈現(xiàn)形式為版本差異,均符合預(yù)期):
# 2.3 修改訂單金額接口
完結(jié)支付分訂單后,且訂單還處于“待支付(USER_PAYING)”狀態(tài)時(shí),可調(diào)用修改訂單金額接口“下調(diào)”訂單的金額,傳值要求與完結(jié)支付分訂單接口傳值要求一致。