小程序前端集成 | my.CheckBeforeAddOrder | 未接入的需要接入。调用接口获取 sourceId,将返回的 sourceId 在后续创建业务订单时传入。 |
服务端-创单 | alipay.open.mini.order.create创建业务订单 | 在现有传参基础上新增 source_id 作为关键入参。订单信息中的商品字段需要保证 order_detail.item_infos.out_item_id 已经同步商品库,并通过商品库的审核生成平台侧商品编码。创建业务订单成功之后,获取 order_id 在创建支付单时传入。传入 source_id 后,即认为接入新的订单链路,不需要在当前接口传入 timeout_express,business_params,order_detail.pay_info 等字段。 |
alipay.trade.create创建支付单 | 在创建业务订单成功后,在 alipay.trade.create(统一收单交易创建接口)的 extend_params.trade_component_order_id 中传入业务订单的 order_id。创建支付单时 product_code 需要传入产品码 JSAPI_PAY。创建支付单时传入的商户订单号 out_trade_no 需要和创建业务订单时的 out_order_id 保持一致。创建支付单的金额 total_amount 与创建业务订单时的金额 order_detail.price_info.order_price 保持一致。创建支付单的时商品信息 goods_detail 不必填;如传入goods_detail,则需与创建业务订单时传入的商品信息 order_detail.item_infos 保持一致(具体字段:order_detail.item_infos.out_item_id、order_detail.item_infos.out_sku_id、quantity、price)。在支付单传入的买家信息 buyer_id 与业务订单的买家信息 buyer_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支付单退款 | 升级后,可直接使用交易退款接口进行退款处理,涉及到退款退分账的参数设置可查看 退款接入指南。需要使用退指定商品(及商品优惠)能力的,可以在refund_goods_detail中传入相关商品信息的out_item_id和out_sku_id。 |