haha/docs/微信支付分智慧零售(无人设备)场景post_payments(后付费项目)字段传参说明.md

1. 概述

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

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

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

2.1 创建支付分订单接口

智慧零售（无人设备）行业的商户在创建支付分订单时，无需回传post_payments【后付费项目】参数，用户购买的商品信息在完结接口进行回传，然后在支付分订单明细中向用户展示所购商品收费信息。

2.2 完结支付分订单接口

当服务结束后，商户调用完结支付分订单接口，需通过post_payments【后付费项目】参数回传订单实际的商品信息，在智慧零售（无人设备）行业中，只允许回传“商品信息”这1类付费项目。

post_payments必须包含至少一笔“商品信息”的后付费项目；若实际收费中，用户购买了多个商品，请按照实际情况添加各“商品信息”的后付费项目明细。

例如：如果用户购买了一个商品A，则只需回传一笔“商品信息”的后付费项目明细，如果用户至购买了一个商品A，一个商品B，共两样商品，则需回传两笔“商品信息”的后付费项目明细，分别对应商品A与商品B，详见传值示例。

post_payments参数传值要求：

字段简称	字段名	类型[长度限制]	是否必填	示例值	描述	传值示例(购买一个商品)	传值示例(购买多个商品)
后付费项目名称	name	string[1, 20]	必填	首重费	付费项目名称，只可填写“商品信息”四个字	"post_payments" : [{ "name" : "商品信息", "amount" : 300, "description": "可乐", "count": 1 }]	"post_payments" : [{ "name" : "商品信息", "amount" : 300, "description": "可乐", "count": 1 }， { "name" : "商品信息", "amount" : 300, "description": "雪碧", "count": 1 }]
后付费项目金额	amount	int	必填	300	付费项目金额，单位为分	"post_payments" : [{ "name" : "商品信息", "amount" : 300, "description": "可乐", "count": 1 }]	"post_payments" : [{ "name" : "商品信息", "amount" : 300, "description": "可乐", "count": 1 }， { "name" : "商品信息", "amount" : 300, "description": "雪碧", "count": 1 }]
后付费项目说明	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 }]
后付费项目的数量	count	int	必填	1	商品数量	"post_payments" : [{ "name" : "商品信息", "amount" : 300, "description": "可乐", "count": 1 }]	"post_payments" : [{ "name" : "商品信息", "amount" : 300, "description": "可乐", "count": 1 }， { "name" : "商品信息", "amount" : 300, "description": "雪碧", "count": 1 }]

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

2.3 修改订单金额接口

完结支付分订单后，且订单还处于“待支付（USER_PAYING）”状态时，可调用修改订单金额接口“下调”订单的金额，传值要求与完结支付分订单接口传值要求一致。