直连支付权限申请支付域名配置接入流程流程图说明

介绍背景

基于小红书小程序的整体背景，交易能力是十分重要的一环，主要包括以下两块

适用范围接入流程

交易组件的接入一共经过上述五个步骤，八个核心插口

交易组件的配置商品库接入

⽀持开发者对商品物料进⾏新增、修改、上下架、查询的管理，商品类目通过类目-搜索插口查询，涉及插口如下：

关于商品初审

当前商品支持先发后审，当商品通过商品-新增/更改插口同步后会触发商品报批。假如初审失败将对商品进行下架处理，此时商品处于系统下架状态，并会通过商品初审反弹异步通知至开发者服务器，开发者也可以通过商品-获取信息插口获取初审结果。假如商品处于系统下架状态，不可通过插口再度上架，须要重新更改商品后再度同步，将会触发新一次初审

小程序下单（直连支付）

目前小红书支付仅支持直连支付模式，须要开发者自行对接陌陌/支付宝的h5支付功能，结合小红书提供的支付插口xhs.requestOrderPayment()进行开发。用户下单支付的金额将直接步入开发者帐户。

直连支付权限申请支付域名配置接入流程

流程图说明

上述流程共须要一个服务端插口和一个小程序api

服务端插口：订单新增/更改

小程序api：xhs.requestOrderPayment()orderInfo参数如下：

xhs.requestOrderPayment()校准的逻辑：

关于改价的说明:requestOrderPayment()之前，调用订单新增/需改插口完成订单的信息更改，返回对应新的开发者陌陌/支付宝h5链接。开发者可以自行更改调起requestOrderPayment()之前的流程。

requestOrderPaymentsuccess、fail、complete并不能感知支付成功。激起收银台后，立刻都会触发。

交易进行中订单状态同步

支付完成时，须要开发者调用订单状态同步插口小红书业务下单，将已支付状态同步至小红书，同时订单状态发生变化时也须要同步节点已发货、已完成、已取消到小红书。状态机如下：

售后单同步&售后单状态同步

假如在交易过程中发生了退货、退款退款等行为，须要开发者同步售后单到小红书，当售后结束，推送售后单状态到小红书。小红书不关心实际售后的过程，由开发者保证，仅须要将最终售后的结果，确认退货或则拒绝退货同步至小红书，涉及的插口如下：

交易完成

在交易完成以后小红书业务下单，可以通过结算恳求插口将订单（包含部份退货的订单）和售后单进行结算分账，平台会在这一环节对技术服务费进行估算（信息估算，不代表具体资金流向），返回平台分账和店家分账结果（信息估算，不代表具体资金流向），并将此订单状态改为已结算。假如在已结算状态以后，仍须要对订单进行退票，须要再度调用售后单同步插口，同步完成以后再调用此插口对结算后的售后单进行结算，并按照文档说明传入after_settle=1发起结算后的售后单结算。发起结算恳求以后，通过查询结算插口输入结算单号发起结算查询。

结算流程图

流程图说明

结算后再度发起售后单结算流程图

注意