创建业务订单（下单）

接口说明

接口名称 component_order
接口模式 直连
异步通知 是

应用场景

  • 商户内部系统创建订单后，商户小程序调用js订单前置判断接口，再通过本接口向平台创建业务订单（动态金额模式），然后商户小程序调用js接口拉起芝麻受理台。
  • 用户在芝麻受理台里进行签约开通服务（首次下单）或确认下单（再次下单），平台对本业务订单信用支付成功后，宝付向商户指定地址通知订单结果、用户签约通知（仅首次下单时）。
  • 商户确认下单成功后（即订单状态为支付成功），可开始计费，待订单完成后结束计费，先创建分期单紧接着再发起扣款交易。

异常处理：

  • 若明确下单失败，即订单状态为“失败（PAY_ERROR）”，如需继续下单，请使用新的商户订单号（outComponentOrderNo），但保持用户协议号（out_agreement_no）不变。
  • 接口支持幂等，若订单状态为“处理中”、“支付中”，商户可原参再次下单

接口参数

  • 请求：
说明 字段 类型 条件 示例值 备注
代理商商户号 agentMerId S(16) 否 100003789 宝付支付分配的商户号
代理商终端号 agentTerId S(16) 否 213003567 宝付支付分配的终端号
交易商户号 merId S(16) 是 102002369 宝付支付分配的商户号
交易终端号 terId S(16) 是 100003123 宝付支付分配的终端号
子商户商户号 subMchId S(64) 是 子商户商户号（smid），由支付宝生成
商户业务订单号 outComponentOrderNo S(32) 是 20210315155012 商户系统内部业务订单号，同一个商户号下唯一
订单扩展参数 orderExtend C 是
通知回调地址 notifyUrl S(256) 是 https://www.example.com/return_url 商户接收本订单信用付成功回调通知的地址；也用于接收用户首次签约开通服务的通知
交易时间 txnTime S(14) 是 20250301103059 格式：yyyyMMddHHmmss
请求预留字段 reqReserved S(255) 否

订单扩展参数

说明 字段 类型 条件 示例值 备注
订单标题 order_title S(255) 是 iPhone14 256G（白色） 不可使用特殊字符，如 /，=，& 等
订单类型 merchant_biz_type S(64) 是 INDIRECT_CHARGE_WITHHOLD 固定值：INDIRECT_CHARGE_WITHHOLD
追踪ID source_id S(128) 是 MjAfSVNfTlVMA== 商户小程序调用支付宝的js方法“my.checkBeforeAddOrder”获取
用户标识 open_id S(128) 是 2088102146225135 买家支付宝用户id （2088开头的user_id）
订单详情 order_detail C 是 详见：【订单详情】
商家小程序对应的订单详情页路径地址 merchant_applet_path S(64) 是 /pages/index/index?orderId=10190608609185 商家小程序对应的订单详情页路径地址value，仅需传入小程序内部页面路径即可；同⼀笔订单的链接必须与第⼀次传⼊的地址相同。使用场景：订单创建后，支付宝app会推送服务消息，用户点击后就会跳转这个地址
芝麻信用信息 credit_info C 是 详见：【芝麻信用信息】
代扣协议签约场景 deduct_sign_scene S(64) 是 INDUSTRY|XIANXIANG_BIKE_CHARGE 商户开通芝麻先享后，由宝付客户经理提供
支付宝前置内容咨询接口返回的渠道信息 channel_operation_info S(1024) 否 #{UCBJeV4wrBfYWZf32QQr0JB…..NrCi/HS/eFwde5MgLzFrBQ==}# 支付宝星移商户前置内容咨询接口返回，用于追溯先享后付的交易发起场景。若商户未对接该接口，则无需送该字段。

订单详情

说明 字段 类型 条件 示例值 备注
订单金额信息 price_info C 是 详见：【订单金额信息】
分期信息 item_installment_info C 是 详见：【分期信息】
商品信息 item_infos C 是 可以传递多个商品信息，是一个JSON数组
详见：【商品信息】
订单金额信息

说明 字段 类型 条件 示例值 备注
订单金额 order_price I 是 99 单位：【分】；因使用浮动金额模式，本字段无实际业务意义，可自定义值，仅为满足渠道接口校验必填性所需
分期信息

说明 字段 类型 条件 示例值 备注
分期数 period_num I 是 1 固定值：1
每期最大金额 period_max_price I 是 10 单位：【分】；二轮/四轮充换电场景下须≤100元，实际扣款金额需不高于此值（含创建分期单的分期金额）；其他场景限额，请咨询宝付支持人员
商品信息

说明 字段 类型 条件 示例值 备注
商品名称 goods_name S(256) 是 商品名称1
商品数量 item_cnt I 是 5
商品单价 sale_price I 是 88 单位：【分】
商品编号 goods_id S(32) 是 1234567 提报支付券优惠时的商品id，用于关联使用支付券，需要和支付券上绑定商品goods_id相同。

芝麻信用信息

说明 字段 类型 条件 示例值 备注
商户自定义用户协议号 out_agreement_no S(8,32) 是 MUA202502061234567890 同一用户下单送相同协议号，不同用户需送不同的协议号。长度在8~32位之内
芝麻外部类目 category_id S(128) 是 credit_pay_for_battery_charging 商户在支付宝开通产品时，由平台分配，请咨询宝付客户经理
是否需要免核身（免确认） no_need_verify_identity boolean 否 false 用户再次下单是否无需核身；默认false-需要核身，此时需要用户在芝麻受理台内确认后，才会下单成功。 注意：①用户首次下单必须核身；②若商户需要免核身功能，需联系支付宝BD申请加白名单
芝麻受理台跳转地址链接 acceptance_jump_url S(128) 否 alipays://platformapi/startapp？2021*21&page=/pages/index/index?orderId=10190608918512 芝麻先享受理台用户开通成功后，商家自定义页面跳转地址
  • 返回：
说明 字段 类型 条件 示例值 备注
代理商商户号 agentMerId S(16) 否 100000 宝付支付分配的商户号
代理商终端号 agentTerId S(16) 否 100000 宝付支付分配的终端号
交易商户号 merId S(16) 是 宝付支付分配的商户号
交易终端号 terId S(16) 是 宝付支付分配的终端号
宝付业务订单号 componentOrderNo S(32) 是 创单成功后，由宝付生成
商户业务订单号 outComponentOrderNo S(128) 是
平台业务订单号 channelOrderNo S(128) 是 创单成功后，由平台生成；商户小程序拉起芝麻受理台时，需送入
业务订单状态 orderState E 否 详见：【业务订单状态】
返回扩展参数 chlRetParam C 否 JSON格式，会根据业务需求动态添加相应字段属性
详见：【渠道返回参数】
业务结果 resultCode S(16) 是 SUCCESS 业务处理结果
错误代码 errCode S(32) 否 当业务结果FAIL时，返回错误代码
错误描述 errMsg S(128) 否 当业务结果为FAIL时，返回错误描述

渠道返回参数

说明 字段 类型 条件 示例值 备注
建议对客展示文案 customer_display_text S(256) 否 同一时间下单人数过多，请稍后重试 平台返回的建议对客展示文案。当接口返回异常时，建议将当前字段对客进行展示
芝麻受理台地址 credit_page_link S(1024) 否 https://renderdev.alipay.com/p/yuyan/.../ 请求免核身，但平台判断仍需核身时，会返回该地址，用于支付宝端外前端跳转拉起芝麻受理台；在手机浏览器内需前拼“https://render.alipay.com/p/s/i?scheme=” 再跳转才能拉起支付宝app
作者：lilizhi  创建时间：2025-03-21 18:42
最后编辑：lilizhi  更新时间：2025-06-17 14:16