西之月接入流程

一、开发前准备

1. 业务确认

联系西之月业务方，核实合作信息

确认无误后，申请接口开放权限

2. 技术联调

与西之月技术团队对接

在测试环境完成接口流程验证

3. 应用部署

生成正式应用

绑定实名认证账号，配置API调用权限

二、接入步骤

1. 全局调用验签

根据平台规则生成 Authorization 令牌

在所有接口请求头中携带该令牌

参考文档：西之月开放API

2. 接入主流程

（1）获取商品

调用接口获取商品信息，用于展示在商家独立站/三方平台

相关接口：

/openapi/product/list（商品列表）

/openapi/product/detail（商品详情）

/openapi/product/skuPriceList（商品档位价格）

/openapi/v2/inventory/skuInventory（SKU库存）

（2）创建采购订单

调用接口生成采购单

相关接口：

/openapi/productCategory/getDeliveryRegions（获取发货区域）

/openapi/logisticsCompany/list（物流公司列表）

/openapi/order/predate（订单预计算）

/openapi/order/upload（提交订单）

（3）支付采购单

商家选择支付方式（第三方支付/账期额度）完成支付

相关接口：

/openapi/pay/list（获取支付方式）

/pages/#/pay/openIndex?order_nos=xxx,xxx&app_id=xxxx（支付页面）

/openapi/pay/pay（发起支付）

（4）查询订单状态

实时获取订单物流及状态

相关接口：

/openapi/v2/order/status（订单状态）

/openapi/v2/order/detail（订单详情）

/openapi/v2/order/track（物流轨迹）

（5）发起售后

处理退货、退款等售后流程

相关接口：

/openapi/afterSale/getApplyDataConfig（售后配置）

/openapi/afterSale/apply（申请售后）

/openapi/afterSale/modify（修改售后）

/openapi/afterSale/revoke（撤销售后）

最小闭环流程图

三、接口能力

能力分类	接口文档
商品能力	查看文档
订单能力	查看文档
支付能力	查看文档
售后能力	查看文档
账期能力	查看文档
品牌授权能力	查看文档
其他能力	查看文档

四、注意事项

技术支持：专属技术顾问群内答疑

接口调用：确保按规范验签，避免调用失败

测试验证：正式上线前务必完成测试环境联调

一、开发前准备#

1. 业务确认#

2. 技术联调#

3. 应用部署#

二、接入步骤#

1. 全局调用验签#

2. 接入主流程#

（1）获取商品#

（2）创建采购订单#

（3）支付采购单#

（4）查询订单状态#

（5）发起售后#

最小闭环流程图#

#

三、接口能力#

四、注意事项#

一、开发前准备

1. 业务确认

2. 技术联调

3. 应用部署

二、接入步骤

1. 全局调用验签

2. 接入主流程

（1）获取商品

（2）创建采购订单

（3）支付采购单

（4）查询订单状态

（5）发起售后

最小闭环流程图

三、接口能力

四、注意事项