H5 接入说明 v1.1
用中台已经做好的页面给用户下单。自建 App / 小程序仍请看开放API文档。
怎么选
| 场景 | 用哪种接入 |
|---|---|
| 用户从福利入口进现成页面选品、购票、买券 | 本文：找运营开通品牌落地页 |
| 已有企业商城，要嵌一条可装修的完整福利商城 | 对外H5链接（托管商城） |
| 你们自己做 App / 小程序 / 后台，要查商品、下单、售后 | 开放API接入文档 |
| 部分业务用托管页面，部分业务自建系统 | 两种可以同时开，按业务选，不要把 H5 入口当成开放API 来调用 |
三种托管 H5 可只开一种，也可同时开通。下面两个都带「闪购」二字，不是同一件事：
| 名称 | 用户实际进入 |
|---|---|
| 淘宝闪购渠道版 | 机构商城，买实物 / 到家商品 |
| 好食期券码 · 闪购渠道 | 券码商城，买到店核销券 |
入口完整链接由运营下发，不同机构域名和参数都不同。下文域名只说明形态，直接打开无效，也不要照搬其它机构的链接。
没有中台后台账号时，向对接运营索取本页链接即可，不必先开通中台登录。
找谁开通
联系开通工单或邮件里的对接运营。还没有对接人时，通过你们现有的中台/商务接口人转交。
开通完成后，运营会书面给出：完整入口链接、测试账号用法、验收是否通过。请以这份书面确认为准。
开通时请提供
三种 H5 都先联系运营。材料齐全后才能配入口。渠道码、机构入口参数由运营分配，租户一般不用自己准备渠道码。
| 都要提供 | 说明 |
|---|---|
| 机构名称、联系人、对接邮箱 | 用于建档和验收通知 |
| 中台租户编号（已有则提供） | 没有则由运营新建 |
| 要开通的产品 | 闪购渠道版 / 淘票票 / 好食期券码，可多选 |
| 测试账号或测试手机号 | 用于开通后点验收链接 |
淘宝闪购渠道版
用户从饿了么 / 闪购福利入口进入，登录后到本机构商城下单。支付方式（支付宝、积分等）以开通时运营确认为准。
入口
正式入口由运营下发。形态上从饿了么渠道页进入，例如：
示例·勿打开https://h5.ele.me/minisite/ …（完整参数由运营写入）
登录完成后进入本机构商城，域名按机构分配，例如部分现网机构使用独立商城域名。请只用运营给的完整链接。
额外需要提供
- 是否已有饿了么 / 淘宝闪购渠道资质；没有则由运营评估可行方案（是否新申请、何时可用以评估结果为准）
- 希望展示的机构名称（用户在福利入口看到的名称）
- 是否使用积分抵扣、积分账户归属（若你们已有积分体系）
用户看到什么
- 从机构福利入口进入闪购页面
- 完成登录或绑定手机号
- 进入本机构商城浏览、加购、下单
- 在收银台按本机构规则付款
- 在福利订单列表查看订单进度
淘票票
用户从机构入口进入影票页，选影院和座位，支付后到影院机台取票。支付方式（积分钱包、收银台等）以开通时运营确认为准。
入口
正式入口由运营下发，会带上本机构参数。域名形态例如：
示例·勿打开https://movie.xxxxx.cn/ …
不要只打开域名根路径。
额外需要提供
- 机构在中台的标识（已有租户编号即可）
- 用户从你们系统跳过来时，用什么识别人（通常是手机号）
- 若有多账户：希望扣哪一类积分 / 钱包
用户看到什么
- 从机构入口进入影票页（已识别身份则免登）
- 选城市、影院、影片、场次和座位
- 按本机构规则支付
- 出票成功后，订单页展示取票二维码和文字码，到影院自助机扫码或输码取票
- 出票失败会按规则自动退回；已支付订单也可由用户发起退款（以开通说明为准）
好食期券码
用户进入券码商城，付款后获得到店核销券。这里的「闪购渠道」只是跳进券码页的一种来源，不是上面的机构实物商城。
入口
正式入口由运营按渠道分别下发。域名形态例如：
示例·勿打开https://voucher.xxxxx.cn/ …
| 渠道 | 用户从哪进来 |
|---|---|
| 企业码 | 企业福利 / 企业码活动页 |
| 闪购渠道 | 淘宝闪购上的券码入口（买券，不是买实物） |
| 合作福利平台 | 已对接的福利平台已登录入口（如部分机构的千元豆） |
额外需要提供
- 开通哪一种渠道（企业码 / 闪购渠道 / 合作福利平台，可多选）
- 企业或机构 ID（已有则提供；没有由运营分配）
- 用户在你们侧的唯一标识规则（如员工号、用户 ID）
用户看到什么
- 从对应渠道入口进入券码商城（已识别身份则免登）
- 浏览券商品、下单并付款
- 出券成功后，订单页展示券码（二维码 + 文字码），到店出示核销
- 取码失败或超时会按规则自动退款；已支付且未核销的券，用户可以申请退款
开通与验收
- 资料交齐后，平台做租户绑定和入口配置。可用时间以运营书面确认为准。若还需饿了么、支付宝、企业码等渠道侧审核，以渠道完成日为准，运营会同步进度。
- 托管 H5 没有与开放API 对等的自助沙箱。验收环境、测试账号由运营指定。
- 收到验收链接后：用约定测试账号打开，按运营指引走通「进入 → 下单 / 出票或出券」。请用小额或测试商品，不要用正式用户做大额试单。
- 运营书面确认验收通过后，即可把入口配给正式用户。
- 中台托管页面本身不用你们开发。若从自有 App、企业站点或福利平台跳入，仍需在你们侧配置运营给的完整跳转地址和用户标识，改入口时以运营新链接为准。
验收通过前请勿把链接发给全部员工或 C 端用户。
文档版本 v1.1，2026-08-28。入口域名以当时运营下发为准。