mall4cloud第三方接口与回调清单
S2B2C 白洞版 · mall4cloud第三方接口与回调清单
第三方接口与回调清单
Section titled “第三方接口与回调清单”现网已提供的开放能力一览。签名算法、字段说明见 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 买家取消)。