得舍开放平台 · 多商户商城 API · 服务端对接

用一套 API,
接入完整的交易能力

商品、订单、会员、分销、营销与消息回调 —— 得舍开放平台把多商户商城的交易全链路开放出来,按 app_id 隔离商户数据,密钥与签名全部在服务端完成。

✓统一 JSON 响应
✓app_id 数据隔离
✓事件回调与对账
📦

商品与库存

商品资料、规格、上下架与库存同步。

🧾

订单与履约

下单、支付状态、发货与售后进度。

👥

会员与分销

会员资料、等级、积分与分销关系。

🔔

消息回调

订单状态等关键事件主动回调到你的服务器,不必轮询。

平台定位

把商城的能力,接进你已有的系统

得舍开放平台基于得舍多商户商城,对外提供 REST 风格的 HTTPS 接口。你不必换掉现有系统,只要按需接入需要的能力。

🏢

商户自有系统

已有 ERP、进销存、财务或客服系统的商家,把商品与订单数据和商城打通,避免两头手工录入。

ERP进销存财务
🧩

第三方服务商

为商户做小程序、APP、私域运营或数据服务的软件公司,用一套接口服务多个商户。

小程序APP私域工具
🛠️

有开发能力的商家

自己团队能写服务端代码,希望把商城的交易能力嵌入自有业务流的商家。

自建前端自动对账
开放能力

六类能力,按需申请

能力按模块授权,未开通的模块不会获得调用权限。具体接口清单与字段说明在接入时随文档提供。

📦

商品与库存

商品基础资料、多规格、价格、上下架状态与库存查询,支持与外部商品库同步。

商品规格库存
🧾

订单与履约

订单查询、支付状态、发货与物流信息、售后进度,支持按时间与状态增量拉取。

订单支付发货
👥

会员与积分

会员资料、会员等级、积分余额与积分流水,便于外部系统识别同一客户。

会员等级积分
🔗

分销与佣金

分销关系、团队结构、佣金明细与结算记录,用于对账和业绩统计。

关系佣金结算
🎫

营销与优惠券

优惠券、活动与可用性校验,方便外部渠道发券或在自有页面展示活动。

优惠券活动
💰

支付与对账

支付结果查询与交易对账数据,按日或按单核对,发现差异及时处理。

支付查询对账
🔔

消息回调

订单创建、支付成功、发货、售后等关键事件可回调到开发者服务器。回调要求验签,并按幂等方式处理重复通知。

事件订阅验签幂等
接入流程

四步接入,从申请到上线

审核、联调、上线三个阶段都有对接人跟进,不需要自己摸索。

01

提交接入申请

说明接入方、使用场景与需要的能力模块,签署接入约定。

02

获取 app_id 与密钥

审核通过后分配 app_id 与密钥,并提供独立测试商户用于联调,避免脏数据进入生产。

03

联调与用例验证

按接口文档完成鉴权、查询与写入联调,覆盖正常流程与异常分支后再申请上线。

04

配置并上线

配置回调地址与 IP 白名单,切换到生产 app_id,进入日常调用与对账。

接口约定

接入前,先看这几条

下面是平台级的通用约定,具体接口路径、字段与示例以接入时提供的接口文档为准。

传输协议全站 HTTPS,不接受明文 HTTP 调用。
数据格式请求与响应均为 JSON(UTF-8)。
统一响应code 表示业务结果,msg 为提示信息,data 为业务数据;以 code 判断成功与否,不要只看 HTTP 状态码。
商户标识每个请求都携带 app_id,平台按 app_id 做商户数据隔离,跨商户数据不可见。
鉴权密钥只保存在服务端,用于生成签名或换取访问令牌;密钥不得出现在前端代码、小程序包或公开仓库。
分页列表接口统一使用 page 与 page_size,响应返回总数,避免一次拉全量。
幂等写入类接口需携带业务幂等键,重复请求不应产生重复数据。
错误码错误码按业务域分段,接入文档中逐条说明含义与处理建议。

示例响应(字段以接入文档为准):

{
  "code": 1,
  "msg": "ok",
  "data": {
    "list": [ ... ],
    "total": 128,
    "page": 1,
    "page_size": 20
  }
}
安全与合规

开放不等于放开,四条底线

接口开放的范围与权限按申请逐项开通,平台侧持续做调用审计。

🔐

传输加密

全链路 HTTPS,密钥与签名信息不出现在 URL 与日志中。

🎚️

最小权限

按能力模块授权,只开通业务真正需要的读写范围。

🧱

数据隔离

所有请求按 app_id 归属校验,一个商户的数据不会出现在另一个商户的响应里。

🧾

调用审计

关键接口的调用留有记录,出现异常时可以回溯到调用方与时间点。

服务与支持

接入路上,有人对接

从申请到上线由对接人跟进:接入咨询、联调答疑、上线检查与故障响应,都走同一条通道。

接入咨询
能力范围资质与场景商务条款
联调支持
签名示例回调联调问题定位
上线检查
密钥保管IP 白名单回调地址
日常运维
异常告警对账核验故障响应
常见问题

接入之前,你可能想知道

开发资源、接入范围、密钥与费用,常见疑问一次说清。

Q.没有开发团队能接入吗?+
开放平台面向服务端对接,接入方需要有至少一名后端开发,或由承接实施的服务商完成对接。没有开发资源的商家可以直接使用得舍商城现成的后台、H5 与小程序。
Q.支持自建小程序或 APP 吗?+
支持。接口面向服务端,前端可以是自建小程序、H5、APP 或企业 ERP,只要服务端能发起 HTTPS 请求并处理回调即可。
Q.密钥泄露了怎么办?+
立即联系平台轮换密钥,旧密钥同时作废并重新生成。密钥只能保存在服务端,不要写进前端代码、小程序包或公开仓库。
Q.可以只接订单,不接商品吗?+
可以。开放能力按模块授权,接入时按需要申请,未开通的模块不会获得调用权限。
Q.接入需要收费吗?+
接入本身不单独收取接入费,是否涉及增值服务与具体资费以商务沟通确认的条款为准。

把商城能力,接进你的系统

提交接入申请,说明使用场景与需要的能力,我们会尽快联系你。

申请接入 → 再看看开放能力
↑

💬微信客服

复制微信号添加咨询

xizhan112233已复制,去微信添加吧
添加时备注「开放平台接入」更快通过
客服在线时间 9:00–22:00