目录和图片一起带走
读取分类层级与分类图片，分页导入商品封面、详情和 SKU。保存商城商品 ID，建立自己的映射关系。
parentId · imageUrl · coverUrlKASUTENG / OPEN PLATFORM
卡速腾开放平台
让你的系统，连接商城的每一笔生意。
从分类与图片，到商品、余额采购与交付查询。
用一套有边界、可追踪的 API，构建你自己的销售渠道。
- 接口协议
- HTTPS + JSON
- 签名校验
- HMAC-SHA256
- 交易保护
- 业务单号幂等
- 账户隔离
- 会员 × 主站 / 分站
01 / API EXPLORER
接口里，有你需要的数据。
示例响应，非实时业务数据。
请求发往你的采购商城，官网只提供文档。
GET
/openapi/v1/products?limit=20&offset=0{
"data": {
"items": [{
"productId": "product-demo",
"name": "示例月卡",
"categoryId": "category-demo",
"coverUrl": "/media/product-demo.png",
"stockStatus": "available",
"minPriceCents": 990,
"maxPriceCents": 2990
}],
"total": 1, "limit": 20, "offset": 0
}
}coverUrl 是商品封面；相对图片地址需拼接采购商城域名。价格为当前会员的实际报价，库存状态不等于库存预留。
完整字段说明02 / CONNECT YOUR COMMERCE
把商品对接，接成完整业务。
从首次导入到持续同步，
每一步都有明确的数据和处理方式。
价格与状态持续同步
按账户读取会员价，检查商品与 SKU 库存。批量状态查询识别不可售商品，及时暂停下游销售。
priceCents · stockStatus · status采购到交付，有始有终
创建订单、核对金额、余额支付，再查询交付结果。超时先按原业务单号查单，避免重复采购。
reference · orders · fulfillment03 / ENDPOINTS
10 个接口，贯通采购链路。
| 能力 | 请求路径 | 用途 |
|---|---|---|
| 分类目录 | GET/openapi/v1/categories | 分类层级、名称、排序和图片 |
| 商品列表 | GET/openapi/v1/products | 分页拉取商品、封面、会员价和库存状态 |
| 商品详情 | GET/openapi/v1/products/{id} | 商品内容、SKU、价格、下单资料 |
| 商品状态 | GET/openapi/v1/product-statuses | 批量检查已对接商品是否仍可见及是否缺货 |
| 账户余额 | GET/openapi/v1/balance | 查询当前商城会员的可用余额 |
| 创建订单 | POST/openapi/v1/orders | 凭业务单号创建待付款采购单 |
| 余额付款 | POST/openapi/v1/orders/{id}/pay | 确认金额后使用商城余额付款 |
| 查询订单 | GET/openapi/v1/orders/{id} | 查询付款与订单状态 |
| 按业务单号查单 | GET/openapi/v1/order-references/{reference} | 请求超时后找回原单，避免重复采购 |
| 交付查询 | GET/openapi/v1/orders/{id}/fulfillment | 跟进履约进度与交付内容 |
批量商品状态接口需要商城 0.1.248 或以上版本。下单与付款为独立步骤；调用付款接口会真实扣除商城会员余额。
04 / GET STARTED
从第一次请求，到稳定运行。
- 01
开通 API 权限
在采购商城注册会员，由商城管理员允许 API 访问。
- 02
生成站点密钥
进入该商城“接口管理”，生成密钥并仅保存在服务端。
- 03
先做只读联调
查询余额、分类和商品，确认价格、图片与下单字段。
- 04
验收采购与同步
小额验证下单、扣款、交付和异常查单，再启用定时同步。
能像卡速售那样，对接分类、图片和商品吗？
可以按本平台 API 开发分类、图片、商品、会员价与库存同步，并完成余额采购、查单和交付查询。采用卡速腾自己的接口路径、字段和 HMAC-SHA256 签名；第三方系统需要适配卡速腾协议，不能直接选“卡速售”后只替换域名。
下架、缺货和接口故障，应该怎么区分？
批量状态返回 published 表示商品对当前账户可见，unavailable 表示下架、无权访问、删除或暂无有效报价；缺货另看 stockStatus。接口返回 5xx 是服务异常，应保留上次结果并重试，不能当作所有商品下架。商品状态不代表一定可下单，最终仍校验库存、营业时间及下单规则。
商品变化会自动推送吗？
本接入流程使用定时拉取分类、商品、价格和状态，订单交付也通过查询跟进。请按文档限流与重试规则调度，不依赖未约定的实时推送。
官网账号与商城采购账号，是同一个吗？
不是。接口域名、会员余额和 API 密钥都属于实际采购的商城或分站。官网负责系统授权、插件和文档，官网控制台的密钥不能用于商城采购。
准备连接你的商城？
从签名示例开始，让每一步请求都有据可查。