# 1. 概述
接入微信支付分的商戶需在創(chuàng)建、完結(jié)、修改訂單金額時,通過API接口中的post_payments參數(shù)回傳詳細的后付費項目明細。該明細將在支付分訂單詳情頁面展示,減少用戶對訂單金額的疑問。
post_payments為數(shù)組類型參數(shù),該參數(shù)可包含多條“后付費項目明細”,至少傳1條明細,最多可傳100條明細,每條“后付費項目明細”包含name、amount、description、count四個參數(shù)。
# 2. 后付費項目參數(shù)傳值要求
# 2.1 創(chuàng)建支付分訂單接口
汽車租賃行業(yè)的商戶在創(chuàng)建支付分訂單時,需通過post_payments【后付費項目】參數(shù)回傳免押租車規(guī)則,以便于在支付分訂單明細中向用戶展示。
post_payments參數(shù)傳值要求:
字段簡稱 | 字段名 | 類型[長度限制] | 是否必填 | 示例值 | 描述 | 傳值示例 |
---|---|---|---|---|---|---|
后付費項目名稱 | name | string [1, 20] | 必填 | 免押租車規(guī)則 | 付費項目名稱,請?zhí)顚憽懊庋鹤廛囈?guī)則”六個字 | "post_payments" : [{"name" : "免押租車規(guī)則","description" : "還車后30天內(nèi)按費用標(biāo)準(zhǔn)核查車損、違章等費用,按實際費用扣費"}] |
后付費項目金額 | amount | int | 不填 | - | 請勿傳該字段 | "post_payments" : [{"name" : "免押租車規(guī)則","description" : "還車后30天內(nèi)按費用標(biāo)準(zhǔn)核查車損、違章等費用,按實際費用扣費"}] |
后付費項目說明 | description | string [1, 30] | 必填 | 還車后30天內(nèi)按費用標(biāo)準(zhǔn)核查車損、違章等費用,按實際費用扣費 | 請?zhí)顚懹嬞M規(guī)則的詳細說明 | "post_payments" : [{"name" : "免押租車規(guī)則","description" : "還車后30天內(nèi)按費用標(biāo)準(zhǔn)核查車損、違章等費用,按實際費用扣費"}] |
后付費項目的數(shù)量 | count | int | 不填 | - | 請勿傳該字段 | "post_payments" : [{"name" : "免押租車規(guī)則","description" : "還車后30天內(nèi)按費用標(biāo)準(zhǔn)核查車損、違章等費用,按實際費用扣費"}] |
后付費項目明細在支付分訂單頁面的實際展示效果:
# 2.2 完結(jié)支付分訂單接口
當(dāng)服務(wù)結(jié)束后,商戶調(diào)用完結(jié)支付分訂單接口,需通過post_payments【后付費項目】參數(shù)回傳訂單實際的付費項目,在汽車租賃行業(yè)中,只允許回傳“租車相關(guān)費用、延遲還車費用、加油費用、ETC高速費用、車損費用、折舊費用、停運費用、闖紅燈違章”這8類付費項目。
若訂單無收款費用,post_payments只能有一項“租車相關(guān)費用”的后付費項目明細;
若訂單有收款費用,實際收費中有“租車相關(guān)費用、延遲還車費用、加油費用、ETC高速費用、車損費用、折舊費用、停運費用、闖紅燈違章”的費用,請按照實際情況填寫后付費項目明細,并至少有其中一項。
例:如果訂單無收款費用(0元完結(jié)訂單),傳參時只能傳“租車相關(guān)費用”這一項后付費項目明細,如果訂單有收款費用(非0元完結(jié)),可以傳“延遲還車費用”、“ETC高速費用”等其他后付費項目明細。
post_payments參數(shù)傳值要求:
字段簡稱 | 字段名 | 類型[長度限制] | 是否必填 | 示例值 | 描述 | 傳值示例(無收款費用) | 傳值示例(有收款費用) |
---|---|---|---|---|---|---|---|
后付費項目名稱 | name | string [1, 20] | 必填 | 租車相關(guān)費用 | 付費項目名稱,只可填寫如下取值 可選取值: 租車相關(guān)費用、延遲還車費用、加油費用、ETC高速費用、車損費用、折舊費用、停運費用、闖紅燈違章 | "post_payments" : [{"name" : "租車相關(guān)費用","description" : "本次無扣款"}] | "post_payments" : [{"name" : "延遲還車費用","amount":1000,"description" : "延遲還車2小時","count":1},{"name" : "ETC高速費用","amount":2000,"description" : "2024年9月1日在深圳高速出口產(chǎn)生高速費用","count":1}] |
后付費項目金額 | amount | int | 選填 | 1200 | 付費項目金額,單位為分 訂單0元完結(jié)時,請勿傳該字段,非0元完結(jié)時必傳該字段 | "post_payments" : [{"name" : "租車相關(guān)費用","description" : "本次無扣款"}] | "post_payments" : [{"name" : "延遲還車費用","amount":1000,"description" : "延遲還車2小時","count":1},{"name" : "ETC高速費用","amount":2000,"description" : "2024年9月1日在深圳高速出口產(chǎn)生高速費用","count":1}] |
后付費項目說明 | description | string [1, 30] | 必傳 | 騎行費用1.5元/30分鐘 | 對付費項目的詳細說明 訂單0元完結(jié)時,只能填寫“本次無扣款”五個字 | "post_payments" : [{"name" : "租車相關(guān)費用","description" : "本次無扣款"}] | "post_payments" : [{"name" : "延遲還車費用","amount":1000,"description" : "延遲還車2小時","count":1},{"name" : "ETC高速費用","amount":2000,"description" : "2024年9月1日在深圳高速出口產(chǎn)生高速費用","count":1}] |
后付費項目的數(shù)量 | count | int | 選填 | - | 訂單0元完結(jié)時,請勿傳該字段,非0元完結(jié)時必傳該字段 | "post_payments" : [{"name" : "租車相關(guān)費用","description" : "本次無扣款"}] | "post_payments" : [{"name" : "延遲還車費用","amount":1000,"description" : "延遲還車2小時","count":1},{"name" : "ETC高速費用","amount":2000,"description" : "2024年9月1日在深圳高速出口產(chǎn)生高速費用","count":1}] |
后付費項目明細在支付分訂單頁面的實際展示效果(左圖為0元完結(jié),右圖為非0元完結(jié)):
# 2.3 修改訂單金額接口
完結(jié)支付分訂單后,且訂單還處于“待支付(USER_PAYING)”狀態(tài)時,可調(diào)用修改訂單金額接口“下調(diào)”訂單的金額,傳值要求與完結(jié)支付分訂單接口傳值要求一致。