跳转到内容

mall4cloud第三方接口与回调清单

S2B2C 白洞版 · mall4cloud第三方接口与回调清单

现网已提供的开放能力一览。签名算法、字段说明见 mall4cloud第三方接口对接协议。

一、第三方开放接口(第三方 → 商城)

Section titled “一、第三方开放接口(第三方 → 商城)”

均为 POST,请求头 grantType: sign。路径前加网关,例如 http://域名:8000 + 下表 Path。

接口 Path 密钥
订单详情 /mall4cloud_order/open/v1/order/get 商家、平台
订单翻页(按下单时间,跨度最大 7 天) /mall4cloud_order/open/v1/order/page 商家、平台
支付单查询(payId 或 orderId) /mall4cloud_payment/open/v1/payment/get 商家、平台
库存查询 /mall4cloud_product/open/v1/stock/get 商家、平台
库存覆盖写入 /mall4cloud_product/open/v1/stock/set 商家、平台。stockPointId 可选,不传则店铺默认仓库
积分查询 /mall4cloud_user/open/v1/score/get 仅平台
积分调账 /mall4cloud_user/open/v1/score/adjust 仅平台
余额查询 /mall4cloud_user/open/v1/balance/get 仅平台
余额调账 /mall4cloud_user/open/v1/balance/adjust 仅平台
成长值查询 /mall4cloud_user/open/v1/growth/get 仅平台
成长值调账 /mall4cloud_user/open/v1/growth/adjust 仅平台

没有:开放下单、回传已支付、开放发货。

二、出站回调(商城 → 第三方 notifyUrl)

Section titled “二、出站回调(商城 → 第三方 notifyUrl)”

在系统密钥上配置地址并勾选事件。一条事件推给所有匹配的密钥。

回调事件 何时推
order.status.changed 订单创建 / 支付待发货 / 发货 / 完成 / 关闭(含超时未支付)
payment.success 支付成功
refund.success 退款成功
stock.changed 可售库存变更
score.changed 积分变更
balance.changed 余额变更(已生效)
growth.changed 成长值变更

没有:商品、SKU、会员资料、优惠券、支付失败。

订单状态用同一事件,看 payload:status=1 待付款,2 待发货,3 待收货,5 完成,6 关闭(closeType=1 超时未支付,4 买家取消)。