开通流程
团购券核销对外仅提供一套接口(见团购券核销),开通完成后接口用法完全一致。差异仅在开通环节,按对接平台分为通用平台与特殊平台两条路径。
1. 开通总览
| 步骤 | 事项 | 说明 |
|---|---|---|
| 1 | 申请接入 | 联系收钱吧运营创建开放平台应用,获取 accessKey/accessSecret,见对接准备 |
| 2 | 平台资质准备 | 按对接平台完成,见第 2、3 节 |
| 3 | 门店映射 | 配置外部系统门店(clientStoreSn)与收钱吧门店(sqbStoreSn)的映射关系,见第 5 节 |
| 4 | 平台授权 | 通过授权链接完成团购平台授权与门店绑定,见第 4 节 |
| 5 | 开始调用 | 按团购券核销调用查券、核销、撤销等接口,联调后上线 |
2. 通用平台开通流程(除美团外的平台)
商家资质与平台应用均由收钱吧统一申请与维护,对接方无需自行入驻团购平台:
- 商户开通:对接方在收钱吧体系内完成签约与门店开通,无需自行入驻团购平台;
- 发起授权:收钱吧开放平台生成授权链接并提供给开发者;
- 完成授权:开发者通过授权链接完成团购平台授权与门店绑定,授权 token 的换取与续期由收钱吧统一维护;
- 开始调用:门店映射与授权完成后,即可按团购券核销调用接口。
3. 特殊平台开通流程(当前仅美团)
商家资质与平台应用归属于品牌方自身,品牌方需先自行完成平台入驻;当前特殊平台仅美团:
- 平台入驻:品牌方以自有主体在美团完成入驻与资质审核,并在美团创建平台应用;
- 应用交付:品牌方将美团应用信息(AppID + 应用密钥)提供给收钱吧,由收钱吧配置保存;
- 发起授权:收钱吧开放平台生成授权链接并提供给开发者;
- 完成授权:开发者通过授权链接登录美团完成授权确认,授权 token 的换取与续期由收钱吧统一维护;
- 开始调用:门店映射与授权完成后,即可按团购券核销调用接口。
美团场景的授权仅支持授权链接方式,不支持收钱吧 App 授权。
4. 授权方式
| 授权方式 | 适用场景 | 说明 |
|---|---|---|
| 授权链接 | 全部场景 | 由收钱吧开放平台生成后提供给开发者,开发者通过链接完成团购平台授权与门店绑定 |
| 收钱吧 App | 通用平台 | 可在收钱吧 App 内授权入口完成团购平台授权与门店绑定 |
任选其一:两种授权方式选择其中一种完成即可,无需重复授权;特殊平台(美团)仅支持授权链接方式。
链接时效:授权链接有时效限制,过期后请联系收钱吧运营重新生成。
多门店场景下,收钱吧开放平台按门店批量生成授权链接,每个
clientStoreSn/sqbStoreSn对应一条独立授权链接。
5. 门店映射
外部系统门店(clientStoreSn)与收钱吧门店(sqbStoreSn)的映射关系由收钱吧统一维护:开发者在申请接入时提供对应关系,由收钱吧完成配置;后续新增、修改或停用映射关系,联系收钱吧运营处理。映射配置方式见对接准备。
生效规则:映射的新增、停用或删除即时生效;历史核销、撤销记录保留,可用于后续查询与对账。