智慧零售(无人设备)

更新时间:2024.12.09

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

付费项目金额,单位为分

后付费项目说明

description

string [1, 30]

必填

可乐

商品名称

后付费项目的数量

count

int

必填

1

商品数量

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

2.3 修改订单金额接口

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