# 1. 概述
接入微信支付分的商戶需在創(chuàng)建、完結(jié)、修改訂單金額時,通過API接口中的post_payments參數(shù)回傳詳細(xì)的后付費項目明細(xì)。該明細(xì)將在支付分訂單詳情頁面展示,減少用戶對訂單金額的疑問。
post_payments為數(shù)組類型參數(shù),該參數(shù)可包含多條“后付費項目明細(xì)”,至少傳1條明細(xì),最多可傳100條明細(xì),每條“后付費項目明細(xì)”包含name、amount、description、count四個參數(shù)。
# 2. 后付費項目參數(shù)傳值要求
# 2.1 創(chuàng)建支付分訂單接口
充電寶行業(yè)的商戶在創(chuàng)建支付分訂單時,需通過post_payments【后付費項目】參數(shù)回傳訂單的收費標(biāo)準(zhǔn),以便于在支付分訂單明細(xì)中向用戶展示。
post_payments參數(shù)傳值要求:
字段簡稱 | 字段名 | 類型[長度限制] | 是否必填 | 示例值 | 描述 | 傳值示例 |
---|---|---|---|---|---|---|
后付費項目名稱 | name | string [1, 20] | 必填 | 收費標(biāo)準(zhǔn) | 付費項目名稱,請?zhí)顚憽笆召M標(biāo)準(zhǔn)”四個字 | "post_payments" : [{"name" : "收費標(biāo)準(zhǔn)","description" : "1元/1小時"}] |
后付費項目金額 | amount | int | 不填 | - | 請勿傳該字段 | "post_payments" : [{"name" : "收費標(biāo)準(zhǔn)","description" : "1元/1小時"}] |
后付費項目說明 | description | string [1, 30] | 必填 | 1元/1小時 | 請?zhí)顚懯召M標(biāo)準(zhǔn)的詳細(xì)說明 | "post_payments" : [{"name" : "收費標(biāo)準(zhǔn)","description" : "1元/1小時"}] |
后付費項目的數(shù)量 | count | int | 不填 | - | 請勿傳該字段 | "post_payments" : [{"name" : "收費標(biāo)準(zhǔn)","description" : "1元/1小時"}] |
后付費項目明細(xì)在支付分訂單頁面的實際展示效果:
# 2.2 完結(jié)支付分訂單接口
當(dāng)服務(wù)結(jié)束后,商戶調(diào)用完結(jié)支付分訂單接口,需通過post_payments【后付費項目】參數(shù)回傳訂單實際的付費項目,在充電寶行業(yè)中,必須同時回傳“收費標(biāo)準(zhǔn)”和“使用時長”這兩類付費項目,并且只能回傳這兩類項目。請參考傳值示例。
post_payments參數(shù)傳值要求:
字段簡稱 | 字段名 | 類型[長度限制] | 是否必填 | 示例值 | 描述 | 傳值示例 |
---|---|---|---|---|---|---|
后付費項目名稱 | name | string [1, 20] | 必填 | 收費標(biāo)準(zhǔn) | 付費項目名稱,只可填寫如下取值 可選取值: 收費標(biāo)準(zhǔn)、使用時長 | "post_payments" : [{"name" : "收費標(biāo)準(zhǔn)","description" : "1元/1小時"},{"name" : "使用時長","description" : "1小時38分20秒"}] |
后付費項目金額 | amount | int | 不填 | - | 請勿傳該字段 | "post_payments" : [{"name" : "收費標(biāo)準(zhǔn)","description" : "1元/1小時"},{"name" : "使用時長","description" : "1小時38分20秒"}] |
后付費項目說明 | description | string [1, 30] | 必填 | 1元/1小時 | 對付費項目的詳細(xì)說明 | "post_payments" : [{"name" : "收費標(biāo)準(zhǔn)","description" : "1元/1小時"},{"name" : "使用時長","description" : "1小時38分20秒"}] |
后付費項目的數(shù)量 | count | int | 不填 | - | 請勿傳該字段 | "post_payments" : [{"name" : "收費標(biāo)準(zhǔn)","description" : "1元/1小時"},{"name" : "使用時長","description" : "1小時38分20秒"}] |
后付費項目明細(xì)在支付分訂單頁面的實際展示效果:
# 2.3 修改訂單金額接口
完結(jié)支付分訂單后,且訂單還處于“待支付(USER_PAYING)”狀態(tài)時,可調(diào)用修改訂單金額接口“下調(diào)”訂單的金額,傳值要求與完結(jié)支付分訂單接口傳值要求一致。