已更新更新时间：2024-12-09 13:55:30文档更新记录 >接入助手收藏订阅更新我的文档设置返回文档说明：本接口规范指引，面向全部接入小程序交易组件的服务商和商家客户。为了提升订单信息的准确性，更严谨的统计订单金额，计算公域技术服务费，提高商家对账效率，支持商家在带货宝等达人带货场景扩大交易规模。即日起，小程序交易组件将加强接口使用规范，您可根据以下指引完成接口调整。注意：本次接口规范公告于 2023 年 11 月 28 日发布，请遵循下述规范尽快调整，交易组件将于 2023 年 12 月 31 日开始执行规范约束，届时如未按规范接入，将无法创建订单，影响买家下单。应用场景创建订单时，您正确传入商品价格、数量、商品优惠、订单金额等信息后，支付宝可依据订单数据准确计算商品实收金额、达人分佣金额及在账单上以商品颗粒度展示账单明细。场景现状规范后达人直播带货一笔订单内有多件商品时，达人分佣金额=订单金额*达人带货商品的佣金率，示例： 达人：分佣金额>实际推广效果；商家：出资金额>实际推广收益；达人分佣金额=实际带货商品金额*佣金率，示例： 达人：获得实际推广佣金；商家：达人推广费用降低；慧推宝账单账单明细不包含用户实付金额账单明细支持透出用户实付金额相关接口说明：以下仅列出了本次需要调整的接口，未列出接口仍正常接入无需调整。环节接口地址创建订单alipay.open.mini.order.create（订单创建接口）创建交易单alipay.trade.create(统一收单交易创建接口)交易退款接入步骤第一步 创建订单调用接口： alipay.open.mini.order.create（订单创建接口）调整点（以下仅列出了本次需要调整的参数，其它参数仍正常入参）：1一笔订单内，商品有 out_sku_id 时，商家商品 sku_id（out_sku_id）不可重复传多次；商品无 out_sku_id 时，商家商品 id(out_item_id) 不可重复传多次。2一笔订单内最多可包含 50 个商品，1 个商品数量最多 100 份。3为了降低交易风险，保障用户交易真实性。自 2023 年 12 月 15 日起，订单类型（merchant_biz_type）为电商购物: （kx_shopping）时，以下字段为必填字段。参数中文名参数英文名类型是否必选长度/取值描述示例值订单收货地址address_infominireceiveraddressinfodto必选-订单收货地址信息-ll收货人姓名receiver_namestring必选长度范围：[1,64]收货人姓名张三ll详细收货地址detailed_addressstring必选长度范围：[1,1024]详细收货地址信息中国浙江省杭州市西湖区xx小区xx号ll收货人手机号tel_numberstring必选长度范围：[1,64]收货人手机号 格式为11位，纯数字132********注意：请遵循操作指引尽快调整，后续小程序报名参加公域活动（如年货节，五福等），商家直播均要求订单信息完整，届时如未按规范接入，可能导致不符合公域活动报名条件而无法报名。4新增参数：商品详细信息 item_infos 下新增可选参数 商家商品优惠金额 item_discount，具体描述详见接口文档。a商家商品优惠金额=（商品单价-商品实际单价）*商品数量b商家优惠金额=sum(商家商品优惠金额)5废弃参数：附加金额 additional_price 参数将不再继续使用，请合理入参。6针对商品单价 sale_price、商品实际单价 sale_real_price、商品数量 item_cnt、运费 freight、商家优惠金额 discounted_price、商家商品优惠金额 item_discount、订单金额 order_price 参数入参时，需要符合如下订单资金平衡校验：a订单金额=sum(商品单价* 商品数量) 运费-商家优惠金额b订单金额=sum(商品实际单价* 商品数量) 运费c订单金额=sum(商品单价* 商品数量-商家商品优惠金额) 运费示例：商品商品单价商品实际单价商品数量商家商品优惠金额商家优惠金额运费订单金额a10元7.5元25元7元0元33元b20元18元12元接入过程中，开发者可使用自助诊断工具进行订单资金平衡校验调试。点击 进入自助诊断工具，选择 交易组件 > 交易组件资金平衡校验。 相关接口参数说明：参数中文名参数英文名类型是否必选长度/取值描述示例值商户商品 idout_item_idstring特殊可选长度范围：[1,64]商户侧商品id，用于公域场景结算，会影响主播归因。私域场景无需传入，公域场景未传入会影响后续结算。无 sku 商品，同一个 item_id 不可重复多次传入必选条件公域场景使用必传（订单前置判断接口返回的 sourceid 不为空）123商户商品 sku_idout_sku_idstring特殊可选长度范围：[1,64]商户侧商品 sku_id，用于公域场景结算，如果商品有 sku 时需要传入准确的 sku_id，无 sku 时不需要传入。同一个 sku_id 不可重复多次传入。必选条件公域场景下，商品提报过多个 out_sku_id 时必传34567576565656商家商品优惠金额item_discountstring可选长度范围：[1,11]商家商品优惠金额，该商品分摊到的优惠金额。所有商品的商家商品优惠金额之和应等于商家优惠金额，即 商家优惠金额=sum(商家商品优惠金额)；单位：元，精确到小数点后两位68.88商家优惠金额discounted_pricestring可选长度范围：[1,11]商家优惠金额，单位：元，精确到小数点后两位。商家优惠金额应等于商家所有商品的商家优惠金额之和，即 商家优惠金额=sum(商家商品优惠金额)、商家商品优惠=（商品单价-商品实际单价）*商品数量。88.88订单金额order_pricestring必选长度范围：[1,11]订单总价，单位：元，精确到小数点后两位订单金额须满足公式：1订单金额=sum(商品单价* 商品数量) 运费-商家优惠金额；2订单金额=sum(商品实际单价* 商品数量) 运费3订单金额=sum(商品单价* 商品数量-商家商品优惠金额) 运费88.88第二步 创建交易单调用接口：alipay.trade.create(统一收单交易创建接口)调整点（以下仅列出了本次需要调整的参数，其它参数仍正常入参）：1goods_id：当前接口的 extend_params.trade_component_order_id 字段不为空时，该字段需与交易组件订单参数保持一致。参数英文名类型是否必选长度/取值描述示例值goods_idstring必选64商品的编号，该参数传入支付券上绑定商品goods_id,倘若无支付券需要消费，该字段传入商品最小粒度的商品 id（如：若商品有 sku 粒度，则传商户 sku 粒度的id）。当前接口的 extend_params.trade_component_order_id 字段不为空时，该字段需与交易组件订单参数保持一致。了解小程序商品请参考：小程序商品apple-01第三步 交易退款调用接口：调整点（以下仅列出了本次需要调整的参数，其它参数仍正常入参）：1out_item_id：交易组件订单申请部分退款时，该字段必填，且与交易组件订单参数保持一致。2out_sku_id：交易组件订单申请部分退款时，该字段必须与交易组件订单参数保持一致。参数英文名类型是否必选长度/取值描述示例值out_item_idstring特殊可选64交易组件订单申请部分退款时，该字段必填，且与交易组件订单参数保持一致。商家侧小程序商品 id，具体使用方式请参考：小程序商品。outitem_01out_sku_idstring特殊可选64交易组件订单申请部分退款时，该字段必须与交易组件订单参数保持一致。商家侧小程序商品 sku id，具体使用方式请参考：小程序商品。outsku_01
