对接准备
1. 接入前置条件
开发者需提交资料，请提供如下信息:
- 开发者企业名称
- 开发者企业地址
- 开发者联系人
- 开发者联系电话
- 开发者联系邮箱（企业邮箱）
- 开发者开发语言
2. 接入步骤
以下为公共接入步骤，所有业务通用：
Step 1：申请接入
联系收钱吧运营同学，提供以下信息：
- 开发者信息、技术对接人及联系方式
- 预计调用量级
Step 2：获取凭证
运营创建应用后，返回凭证：
{
"accessKey": "ak_live_xK9mP2nQ7wR4tY6z",
"accessSecret": "sk_live_aB3cD5eF7gH9jK1mN3pQ5rS7tU9vW1xY"
}
重要：
accessSecret仅在创建时显示一次，请妥善保存；丢失后需联系运营重置（accessKey不变）。
Step 3：开始调用
按各接口文档调用订单查询、订单消息推送接收、商品库存变更查询接口。
3. 业务前置
以下前置条件按业务需要完成：
3.1 门店映射（所有业务公共前置）
外部门店（开发者自有门店，
clientStoreSn）与收钱吧门店（sqbStoreSn，158 开头门店号）的映射关系由平台统一维护。
开发者在申请接入时向收钱吧运营提供 clientStoreSn 与收钱吧门店号（sqbStoreSn）的对应关系，由平台完成映射；后续如需新增、修改或停用映射关系，需联系收钱吧运营同学处理。各接口调用时只需传 clientStoreSn，平台会根据映射关系定位收钱吧门店并校验授权；如同时传 sqbStoreSn，则以 sqbStoreSn 为准，平台会校验其与 clientStoreSn 的映射关系。
3.2 订单业务：推送接收通道
若需接收订单消息推送，需为各消息类型提供公网可达的 HTTPS 回调地址并完成验签，详见订单消息推送。
4. 接入信息
| 项目 | 说明 |
|---|---|
| BaseURL | https://gateway-smart.shouqianba.com |
| 接口路径 | 接口文档中的路径即完整路径（已含网关前缀 /open-api），完整地址 = Base URL + 接口路径。例如： https://gateway-smart.shouqianba.com/open-api/v1/order/query |
| 凭证示例 | accessKey：ak_live_...；accessSecret：sk_live_... |
| 请求字符集 | UTF-8，JSON 格式 |
| 请求方法 | POST |
5. 超时设置
下游可能调用三方平台 API，超时偏长属正常现象。
| 超时类型 | 推荐值 |
|---|---|
| 连接超时 | 3 秒 |
| 读取超时 | 5 秒 |
| 写入超时 | 5 秒 |
6. 凭证管理
| 状态 | 说明 |
|---|---|
| ACTIVE | 正常可用 |
| SUSPENDED | 已暂停，凭证状态检查阶段即拒绝请求 |
| REVOKED | 已吊销，需联系运营重新申请 |
凭证生命周期由管理后台统一维护。accessSecret 丢失需重置（accessKey 不变），仅创建/重置时展示一次。