# 1. 概述
接入微信支付分的商戶需在創(chuàng)建、完結(jié)、修改訂單金額時(shí)，通過API接口中的post_payments參數(shù)回傳詳細(xì)的后付費(fèi)項(xiàng)目明細(xì)。該明細(xì)將在支付分訂單詳情頁面展示，減少用戶對(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)建支付分訂單接口
共享單車行業(yè)的商戶在創(chuàng)建支付分訂單時(shí)，需通過post_payments【后付費(fèi)項(xiàng)目】參數(shù)回傳訂單的計(jì)費(fèi)規(guī)則，以便于在支付分訂單明細(xì)中向用戶展示。
post_payments參數(shù)傳值要求：
| 字段簡(jiǎn)稱 | 字段名 | 類型[長(zhǎng)度限制] | 是否必填 | 示例值 | 描述 | 傳值示例 |
|---|---|---|---|---|---|---|
| 后付費(fèi)項(xiàng)目名稱 | name | string [1, 20] | 必填 | 計(jì)費(fèi)規(guī)則 | 付費(fèi)項(xiàng)目名稱，請(qǐng)?zhí)顚憽坝?jì)費(fèi)規(guī)則”四個(gè)字 | "post_payments" : [{"name" : "計(jì)費(fèi)規(guī)則","description" : "騎行費(fèi)用1.5元/30分鐘"}] |
| 后付費(fèi)項(xiàng)目金額 | amount | int | 不填 | - | 請(qǐng)勿傳該字段 | "post_payments" : [{"name" : "計(jì)費(fèi)規(guī)則","description" : "騎行費(fèi)用1.5元/30分鐘"}] |
| 后付費(fèi)項(xiàng)目說明 | description | string [1, 30] | 必填 | 騎行費(fèi)用1.5元/30分鐘 | 請(qǐng)?zhí)顚懹?jì)費(fèi)規(guī)則的詳細(xì)說明 | "post_payments" : [{"name" : "計(jì)費(fèi)規(guī)則","description" : "騎行費(fèi)用1.5元/30分鐘"}] |
| 后付費(fèi)項(xiàng)目的數(shù)量 | count | int | 不填 | - | 請(qǐng)勿傳該字段 | "post_payments" : [{"name" : "計(jì)費(fèi)規(guī)則","description" : "騎行費(fèi)用1.5元/30分鐘"}] |
后付費(fèi)項(xiàng)目明細(xì)在支付分訂單頁面的實(shí)際展示效果（以下兩種呈現(xiàn)形式為版本差異，均符合預(yù)期）：
# 2.2 完結(jié)支付分訂單接口
當(dāng)服務(wù)結(jié)束后，商戶調(diào)用完結(jié)支付分訂單接口，需通過post_payments【后付費(fèi)項(xiàng)目】參數(shù)回傳訂單實(shí)際的付費(fèi)項(xiàng)目，在共享單車行業(yè)中，只允許回傳“計(jì)費(fèi)規(guī)則、騎行時(shí)長(zhǎng)、騎行費(fèi)用、調(diào)度費(fèi)用、頭盔費(fèi)用、罰款”這6類付費(fèi)項(xiàng)目。
post_payments必須包含一項(xiàng)“計(jì)費(fèi)規(guī)則”和一項(xiàng)“騎行時(shí)長(zhǎng)”的后付費(fèi)項(xiàng)目明細(xì)；若實(shí)際收費(fèi)中，還有“騎行費(fèi)用”“調(diào)度費(fèi)用”“頭盔費(fèi)用”“罰款”，請(qǐng)按照實(shí)際情況添加后付費(fèi)項(xiàng)目明細(xì)。
例：如果訂單沒有“騎行費(fèi)用、調(diào)度費(fèi)用、頭盔費(fèi)用、罰款”這些付費(fèi)項(xiàng)目，傳參時(shí)只需傳“計(jì)費(fèi)規(guī)則”“騎行時(shí)長(zhǎng)”兩項(xiàng)后付費(fèi)項(xiàng)目明細(xì)，如果有“騎行費(fèi)用”，則需要傳“計(jì)費(fèi)規(guī)則”“騎行時(shí)長(zhǎng)”“騎行費(fèi)用”三項(xiàng)后付費(fèi)項(xiàng)目明細(xì)。
post_payments參數(shù)傳值要求：
| 字段簡(jiǎn)稱 | 字段名 | 類型[長(zhǎng)度限制] | 是否必填 | 示例值 | 描述 | 傳值示例（只有必填的項(xiàng)目明細(xì)） | 傳值示例（含選填的項(xiàng)目明細(xì)） |
|---|---|---|---|---|---|---|---|
| 后付費(fèi)項(xiàng)目名稱 | name | string [1, 20] | 必填 | 計(jì)費(fèi)規(guī)則 | 付費(fèi)項(xiàng)目名稱，只可填寫如下取值 可選取值： 計(jì)費(fèi)規(guī)則、騎行時(shí)長(zhǎng)、騎行費(fèi)用、調(diào)度費(fèi)用、頭盔費(fèi)用、罰款 | "post_payments" : [{"name" : "計(jì)費(fèi)規(guī)則","description" : "騎行費(fèi)用1.5元/30分鐘"}，{"name" : "騎行時(shí)長(zhǎng)","description" : "1小時(shí)38分20秒"}] | "post_payments" : [{"name" : "計(jì)費(fèi)規(guī)則","description" : "騎行費(fèi)用1.5元/30分鐘"}，{"name" : "騎行時(shí)長(zhǎng)","description" : "1小時(shí)38分20秒"}，{"name" : "騎行費(fèi)用","amount" : 600}] |
| 后付費(fèi)項(xiàng)目金額 | amount | int | 選填 | 1200 | 付費(fèi)項(xiàng)目金額，單位為分 付費(fèi)名稱為“計(jì)費(fèi)規(guī)則”“騎行時(shí)長(zhǎng)”時(shí)請(qǐng)勿傳該字段，其他付費(fèi)名稱必傳該字段 | "post_payments" : [{"name" : "計(jì)費(fèi)規(guī)則","description" : "騎行費(fèi)用1.5元/30分鐘"}，{"name" : "騎行時(shí)長(zhǎng)","description" : "1小時(shí)38分20秒"}] | "post_payments" : [{"name" : "計(jì)費(fèi)規(guī)則","description" : "騎行費(fèi)用1.5元/30分鐘"}，{"name" : "騎行時(shí)長(zhǎng)","description" : "1小時(shí)38分20秒"}，{"name" : "騎行費(fèi)用","amount" : 600}] |
| 后付費(fèi)項(xiàng)目說明 | description | string [1, 30] | 選填 | 騎行費(fèi)用1.5元/30分鐘 | 對(duì)付費(fèi)項(xiàng)目的詳細(xì)說明 付費(fèi)名稱為“計(jì)費(fèi)規(guī)則”“騎行時(shí)長(zhǎng)”時(shí)必傳該字段，其他付費(fèi)名稱請(qǐng)勿傳該字段 | "post_payments" : [{"name" : "計(jì)費(fèi)規(guī)則","description" : "騎行費(fèi)用1.5元/30分鐘"}，{"name" : "騎行時(shí)長(zhǎng)","description" : "1小時(shí)38分20秒"}] | "post_payments" : [{"name" : "計(jì)費(fèi)規(guī)則","description" : "騎行費(fèi)用1.5元/30分鐘"}，{"name" : "騎行時(shí)長(zhǎng)","description" : "1小時(shí)38分20秒"}，{"name" : "騎行費(fèi)用","amount" : 600}] |
| 后付費(fèi)項(xiàng)目的數(shù)量 | count | int | 不填 | - | 請(qǐng)勿傳該字段 | "post_payments" : [{"name" : "計(jì)費(fèi)規(guī)則","description" : "騎行費(fèi)用1.5元/30分鐘"}，{"name" : "騎行時(shí)長(zhǎng)","description" : "1小時(shí)38分20秒"}] | "post_payments" : [{"name" : "計(jì)費(fèi)規(guī)則","description" : "騎行費(fèi)用1.5元/30分鐘"}，{"name" : "騎行時(shí)長(zhǎng)","description" : "1小時(shí)38分20秒"}，{"name" : "騎行費(fèi)用","amount" : 600}] |
后付費(fèi)項(xiàng)目明細(xì)在支付分訂單頁面的實(shí)際展示效果（以下兩種呈現(xiàn)形式為版本差異，均符合預(yù)期）：
# 2.3 修改訂單金額接口
完結(jié)支付分訂單后，且訂單還處于“待支付（USER_PAYING）”狀態(tài)時(shí)，可調(diào)用修改訂單金額接口“下調(diào)”訂單的金額，傳值要求與完結(jié)支付分訂單接口傳值要求一致。
