已更新更新时间：2024-11-21 10:15:38文档更新记录 >接入助手收藏订阅更新我的文档设置返回文档注意：存量用户升级新版本，需要绑定 jsapi支付。服务商需根据 第三方应用授权 指引，重新获取商家代开发授权，以此获取 app_auth_token（商家授权令牌）用于调用产品相关接口。商家集成主要变化点：●公私域交易场景区分更清晰：jsapi 支付、 小程序交易组件。●业务单、支付单分离：商家在获取平台判断校验之后决定是否调用交易组件订单创建接口，两者松耦合。交易组件新老接口差异已集成商户升级改造改造点集成接口调用技术变更小程序前端集成my.checkbeforeaddorder1未接入的需要接入。2调用接口获取 sourceid，将返回的 sourceid 在后续创建业务订单时传入。服务端-创单alipay.open.mini.order.create创建业务订单1在现有传参基础上新增 source_id 作为关键入参。2订单信息中的商品字段需要保证 order_detail.item_infos.out_item_id 已经同步商品库，并通过商品库的审核生成平台侧商品编码。3创建业务订单成功之后，获取 order_id 在创建支付单时传入。4传入 source_id 后，即认为接入新的订单链路，不需要在当前接口传入 timeout_express,business_params,order_detail.pay_info 等字段。alipay.trade.create创建支付单1在创建业务订单成功后，在 alipay.trade.create（统一收单交易创建接口）的 extend_params.trade_component_order_id 中传入业务订单的 order_id。2创建支付单时 product_code 需要传入产品码 jsapi_pay。3创建支付单时传入的商户订单号 out_trade_no 需要和创建业务订单时的 out_order_id 保持一致。4创建支付单的金额 total_amount 与创建业务订单时的金额 order_detail.price_info.order_price 保持一致。5创建支付单的时商品信息 goods_detail 不必填；如传入goods_detail，则需与创建业务订单时传入的商品信息 order_detail.item_infos 保持一致（具体字段：order_detail.item_infos.out_item_id、order_detail.item_infos.out_sku_id、quantity、price）。6在支付单传入的买家信息 buyer_id（buyer_open_id） 与业务订单的买家信息 buyer_id（buyer_open_id） 需要保持一致。客户端-支付my.tradepay支付单支付在创建支付单成功后，将返回的交易号 trade_no 作为 my.tradepay 接口的入参 tradeno，拉起收银台进行支付。服务端-关单（可选）alipay.trade.close支付单关闭用于交易创建后，用户在一定时间内未进行支付，可调用该接口，传入支付单号 trade_no，直接将未付款的交易进行关闭。服务端-查询（可选）alipay.trade.query支付单查询传入支付单的交易号 trade_no 查询支付单信息。alipay.open.mini.order.query业务订单查询传入 order_id 查询业务订单信息。服务端-通知支付单通知商家可以通过在 alipay.trade.create（统一收单交易创建接口）设置异步通知（notify_url）来获得支付宝服务端返回的支付结果，当异步通知中返回的 trade_status（交易状态）为 trade_success 时，表示支付成功。服务端-分账通知alipay.open.mini.order.settle.notify业务订单结算通知在公域场景接入 小程序交易组件，出于保护消费者体验角度新增了账期结算，根据不同商品类型需要在履约完成后一定周期结算。为保障分账成功率，请接入订单结算通知，在收到通知之后发起分账请求。服务端-退款alipay.trade.refund支付单退款1升级后，可直接使用交易退款接口进行退款处理，涉及到退款退分账的参数设置可查看 。2需要使用退指定商品（及商品优惠）能力的，可以在refund_goods_detail中传入相关商品信息的out_item_id和out_sku_id。新方案下单据类型说明单据名称阶段使用场景接口和字段名称交易组件业务订单号order_id创单创建业务订单alipay.open.mini.order.create（订单创建接口）返回 order_id。创建支付单：业务订单与支付单绑定alipay.trade.create（统一收单交易创建接口）传入 extend_params.trade_component_order_id。履约订单发货接口传入 order_id（或商家订单号 out_order_id）。订单确认收货接口 传入 order_id（或商家订单号 out_order_id）。订单确认结算通知alipay.open.mini.order.settle.notify（结算消息通知接口）消息包含 order_id（和商家订单号 out_order_id）。其它订单查询alipay.open.mini.order.query（查询订单接口） 传入 order_id（或商家订单号 out_order_id）。支付宝交易号trade_no创单创建支付单alipay.trade.create（统一收单交易创建接口）返回trade_no。支付唤起收银台时传入 传入 tradeno。异步通知alipay.trade.create（统一收单交易创建）消息包含 trade_no（和商家订单号 out_trade_no）。其它查询交易信息 alipay.trade.query（统一收单交易查询）传入 trade_no（或商家订单号 out_trade_no）。支付单退款（传入 trade_no（或商家订单号 out_trade_no）。支付单关单传入 trade_no（或商家订单号 out_trade_no）。注意：交易组件业务订单 和 支付宝支付单 应对应商户的同一笔订单，因此创建业务单时传入的 out_order_id 和创建支付单时传入的 out_trade_no 应保持一致。
