开通流程

团购券核销对外仅提供一套接口(见团购券核销),开通完成后接口用法完全一致。差异仅在开通环节,按对接平台分为通用平台特殊平台两条路径。

1. 开通总览

步骤 事项 说明
1 申请接入 联系收钱吧运营创建开放平台应用,获取 accessKey/accessSecret,见对接准备
2 平台资质准备 按对接平台完成,见第 2、3 节
3 门店映射 配置外部系统门店(clientStoreSn)与收钱吧门店(sqbStoreSn)的映射关系,见第 5 节
4 平台授权 通过授权链接完成团购平台授权与门店绑定,见第 4 节
5 开始调用 团购券核销调用查券、核销、撤销等接口,联调后上线

2. 通用平台开通流程(除美团外的平台)

商家资质与平台应用均由收钱吧统一申请与维护,对接方无需自行入驻团购平台

  1. 商户开通:对接方在收钱吧体系内完成签约与门店开通,无需自行入驻团购平台;
  2. 发起授权:收钱吧开放平台生成授权链接并提供给开发者;
  3. 完成授权:开发者通过授权链接完成团购平台授权与门店绑定,授权 token 的换取与续期由收钱吧统一维护;
  4. 开始调用:门店映射与授权完成后,即可按团购券核销调用接口。

3. 特殊平台开通流程(当前仅美团)

商家资质与平台应用归属于品牌方自身,品牌方需先自行完成平台入驻;当前特殊平台仅美团

  1. 平台入驻:品牌方以自有主体在美团完成入驻与资质审核,并在美团创建平台应用;
  2. 应用交付:品牌方将美团应用信息(AppID + 应用密钥)提供给收钱吧,由收钱吧配置保存;
  3. 发起授权:收钱吧开放平台生成授权链接并提供给开发者;
  4. 完成授权:开发者通过授权链接登录美团完成授权确认,授权 token 的换取与续期由收钱吧统一维护;
  5. 开始调用:门店映射与授权完成后,即可按团购券核销调用接口。

美团场景的授权仅支持授权链接方式,不支持收钱吧 App 授权。

4. 授权方式

授权方式 适用场景 说明
授权链接 全部场景 由收钱吧开放平台生成后提供给开发者,开发者通过链接完成团购平台授权与门店绑定
收钱吧 App 通用平台 可在收钱吧 App 内授权入口完成团购平台授权与门店绑定

任选其一:两种授权方式选择其中一种完成即可,无需重复授权;特殊平台(美团)仅支持授权链接方式。

链接时效:授权链接有时效限制,过期后请联系收钱吧运营重新生成。

多门店场景下,收钱吧开放平台按门店批量生成授权链接,每个 clientStoreSn / sqbStoreSn 对应一条独立授权链接。

5. 门店映射

外部系统门店(clientStoreSn)与收钱吧门店(sqbStoreSn)的映射关系由收钱吧统一维护:开发者在申请接入时提供对应关系,由收钱吧完成配置;后续新增、修改或停用映射关系,联系收钱吧运营处理。映射配置方式见对接准备

生效规则:映射的新增、停用或删除即时生效;历史核销、撤销记录保留,可用于后续查询与对账。

results matching ""

    No results matching ""