---
url: "https://pay.weixin.qq.com/doc/v3/partner/4012586147.md"
title: "酒店行业"
doc_id: 4012586147
---

>更新时间：2024.12.09

## 1. 概述

接入微信支付分的商户需在创建、完结、修改订单金额时，通过API接口中的post\_payments参数回传详细的后付费项目明细。该明细将在支付分订单详情页面展示，减少用户对订单金额的疑问。

post\_payments为数组类型参数，该参数可包含多条“后付费项目明细”，至少传1条明细，最多可传100条明细，每条“后付费项目明细”包含name、amount、description、count四个参数。

## 2. 后付费项目参数传值要求

### 2.1 创建支付分订单接口

酒店行业的商户在[创建支付分订单](https://pay.weixin.qq.com/doc/v3/partner/4013138534.md)时，需通过post\_payments【后付费项目】参数回传订单的酒店房费，以便于在支付分订单明细中向用户展示。

post\_payments参数传值要求：

|     |     |     |     |     |     |     |
| --- | --- | --- | --- | --- | --- | --- |
| 字段简称 | 字段名 | 类型\[长度限制\] | 是否必填 | 示例值 | 描述 | 传值示例 |
| 后付费项目名称 | name | string \[1, 20\] | 必填 | 酒店房费 | 付费项目名称，请填写“酒店房费”四个字 | "post\_payments" :  \[{<br>    "name" :   "酒店房费",<br>    "amount" : 1200,<br>    "description": "北京中关村某酒店标准间"<br>}\] |
| 后付费项目金额 | amount | int | 必填 | 1200 | 付费项目金额，单位为分 | "post\_payments" :  \[{<br>    "name" :   "酒店房费",<br>    "amount" : 1200,<br>    "description": "北京中关村某酒店标准间"<br>}\] |
| 后付费项目说明 | description | string \[1, 30\] | 必填 | 北京中关村某酒店标准间 | 请填写酒店房费的详细说明 | "post\_payments" :  \[{<br>    "name" :   "酒店房费",<br>    "amount" : 1200,<br>    "description": "北京中关村某酒店标准间"<br>}\] |
| 后付费项目的数量 | count | int | 不填 | - | 请勿传该字段 | "post\_payments" :  \[{<br>    "name" :   "酒店房费",<br>    "amount" : 1200,<br>    "description": "北京中关村某酒店标准间"<br>}\] |

后付费项目明细在支付分订单页面的实际展示效果（以下两种呈现形式为版本差异，均符合预期）：

![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/a044ceac8b8b7e3022980058ae5f58f0.png)

### 2.2 完结支付分订单接口

当服务结束后，商户调用[完结支付分订单](https://pay.weixin.qq.com/doc/v3/partner/4013138598.md)接口，需通过post\_payments【后付费项目】参数回传订单实际的付费项目，在酒店行业中，只允许回传“酒店房费、其他杂费”这2类付费项目。

post\_payments必须包含一笔“酒店房费”的后付费项目；若实际收费中，还有“其他杂费”，请按照实际情况添加后付费项目明细。

例如：如果只有一笔后付费项目，只能传“酒店房费”，如果有多笔后付费项目，则必须包含一笔“酒店房费”，其他的费用按照“其他杂费”来补充后付费项目明细，详见传值示例。

post\_payments参数传值要求：

|     |     |     |     |     |     |     |     |
| --- | --- | --- | --- | --- | --- | --- | --- |
| 字段简称 | 字段名 | 类型\[长度限制\] | 是否必填 | 示例值 | 描述 | 传值示例(只有酒店房费) | 传值示例(包含其他杂费) |
| 后付费项目名称 | name | string\[1, 20\] | 必填 | 酒店房费 | 付费项目名称，只可填写如下取值<br>可选取值：<br>酒店房费、其他杂费 | "post\_payments" :  \[{<br>    "name" :   "酒店房费",<br>    "amount" : 1200,<br>    "description": "北京中关村某酒店标准间"<br>}\] | "post\_payments" :  \[{<br>    "name" :   "酒店房费",<br>    "amount" : 1200,<br>    "description": "北京中关村某酒店标准间"<br>}, {<br>    "name" :   "其他杂费",<br>    "amount" : 200,<br>    "description": "房间清洁费"<br>}\] |
| 后付费项目金额 | amount | int | 必填 | 1200 | 付费项目金额，单位为分 | "post\_payments" :  \[{<br>    "name" :   "酒店房费",<br>    "amount" : 1200,<br>    "description": "北京中关村某酒店标准间"<br>}\] | "post\_payments" :  \[{<br>    "name" :   "酒店房费",<br>    "amount" : 1200,<br>    "description": "北京中关村某酒店标准间"<br>}, {<br>    "name" :   "其他杂费",<br>    "amount" : 200,<br>    "description": "房间清洁费"<br>}\] |
| 后付费项目说明 | description | string \[1, 30\] | 必填 | 北京中关村某酒店标准间 | 对付费项目的详细说明 | "post\_payments" :  \[{<br>    "name" :   "酒店房费",<br>    "amount" : 1200,<br>    "description": "北京中关村某酒店标准间"<br>}\] | "post\_payments" :  \[{<br>    "name" :   "酒店房费",<br>    "amount" : 1200,<br>    "description": "北京中关村某酒店标准间"<br>}, {<br>    "name" :   "其他杂费",<br>    "amount" : 200,<br>    "description": "房间清洁费"<br>}\] |
| 后付费项目的数量 | count | int | 不填 | - | 请勿传该字段 | "post\_payments" :  \[{<br>    "name" :   "酒店房费",<br>    "amount" : 1200,<br>    "description": "北京中关村某酒店标准间"<br>}\] | "post\_payments" :  \[{<br>    "name" :   "酒店房费",<br>    "amount" : 1200,<br>    "description": "北京中关村某酒店标准间"<br>}, {<br>    "name" :   "其他杂费",<br>    "amount" : 200,<br>    "description": "房间清洁费"<br>}\] |

后付费项目明细在支付分订单页面的实际展示效果（以下两种呈现形式为版本差异，均符合预期）：

![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/94cf55614ad556343b58689756e6068f.png)

### 2.3 修改订单金额接口

完结支付分订单后，且订单还处于“待支付（USER\_PAYING）”状态时，可调用[修改支付分订单金额](https://pay.weixin.qq.com/doc/v3/partner/4013138819.md)接口“下调”订单的金额，传值要求与完结支付分订单接口传值要求一致。