校园团餐接入指南

更新时间：2025-09-25 19:03:06

方案介绍

校园食堂（主要为大学和中职学校的食堂）已经开始支持受理移动支付，学生和教职工可以通过手机扫码支付来就餐，刷卡不在是唯一的就餐方式，学校食堂支付受理方式的多样化，也给校园团餐行业带来新的发展机遇，带动整个行业进行大规模的软硬件升级。同时支付宝的服务商也面向校园团餐行业推出了各种软硬一体的解决方案，结合支付宝支付、会员、营销和IoT能力，助力行业进行改造升级。

本方案主要介绍在校园团餐行业，服务商如何接入支付宝的基础能力来搭建校园团餐解决方案，同时也希望能够跟校园团餐行业内的服务商进行共创，不断的丰富和完善行业基础能力，推充更多更好的解决解决方案。

校园食堂场景

下面是校园食堂受理移动支付的场景图，供大家参考

用户价值

校园食堂是校园师生日常生活的高频场景，移动支付的进入给大家校园生活增加了便利。

●

无需携带饭卡，忘卡、丢卡等尴尬瞬间没有了

●

无需饭卡充值，资金支配更灵活

●

符合用户支付习惯，校内校外无需切换

●

活动优惠，享受商家和平台提供的各种红包和优惠

商户价值

服务商校园团餐的解决方案也为学校（包括在学校内经营食堂的商户）创造了价值。

●

满足在校师生使用移动支付诉求，以人为本的校园文化

●

无需办理临时卡，来访人员通过手机支付即可在校园内就餐，不用再去走办理临时卡和退卡流程

●

提升校园信息化水平，通过手机打通学校的缴费、就餐等各种线上和下线场景，提升数据治理水平

●

提升食堂运营水平，通过团餐解决方案帮助食堂提升进销存的精细化管理水平

当面付接入

校园食堂商户需要接入支付宝当面付产品来实现收款，当面付产品支持条码支付（商户扫用户）和扫码支付（用户扫商户）两种付款方式，其中条码支付更适合校园食堂场景，而扫码支付则可以作为补充方式来处理断网导致条码支付无法使用的异常情况，下面是两种方案的对比分析：

优点

缺点

条码支付

●

速度快，大概1.5s完成交易

●

无法逃单，每笔交易都有播报

●

支付速度依赖网络速度

●

断网不可用

扫码支付

●

不依赖网络

●

甚至不需要受理设备（商户静态码贴纸和立牌），但如果生成的订单动态码是需要受理设备

●

容易逃单，交易高峰期容易发生逃单现象，造成商家资金损失

当面付介绍

校园团餐行业需要接入标准的当面付产品。

当面付产品介绍请参考：https://opendocs.alipay.com/open/194/105072

收款商户类型

校园团餐当前分成学校经营和社会经营两种，学校经营的收款主体为学校，社会经营的收款主体为承包食堂的商户，这两种主体在支付宝内分别对应不同的经营类目，在帮助商户创建支付宝账户和签约当面付时，都需要选对经营类目：

●

大学与学院：教育部定期公布的全国高等学校名单

●

中小学校：包括小学、初中、普通高中和中职学校

●

校园团餐：在学校承包食堂的餐饮公司，同时能够提供跟学校合作的团餐合作证明，请联系支付宝业务人员提供证明模板

签约费率

大学与学院、中小学校和校园团餐等经营类目的商户主体签约当面付的费率为“0”。

返佣传参

根据当前校园团餐的行业政策，服务商在帮助商户接入当面付时，需要在相关的API种传入服务商签约返佣协议的支付宝账户的PID，而不是签约的支付宝账号。

请参考下面的文档来获取PID：https://opendocs.alipay.com/common/02ncut

建议服务商接入的所有订单都加入 “sys_service_provider_id”参数，并检查参数是否正确，系统商如果传入错误的参数将无法获得返佣。

支持传入“sys_service_provider_id”的订单接口为：

●

创建条码支付订单：alipay.trade.pay（统一收单交易支付接口）

●

创建扫码支付动态码订单：alipay.trade.precreate（统一收单线下交易预创建）

●

创建扫码支付静态码订单：alipay.trade.create（统一收单交易创建接口）

应用类型

服务商在帮助学校（商户）接入校园团餐业务时，在开放平台创建的应用类型必须为“第三方应用”，第三方应用模式能够减少在应用开发过程种跟商户沟通的环节，提升商户拓展效率。

第三方应用请参考：https://opendocs.alipay.com/open/200/105894

条码支付接入

条码支付快速接入请参考：https://opendocs.alipay.com/open/194/106039

扫码支付接入

扫码支付可以有两种接入方式，一种是扫商户受理设备上生成的订单二维码进行支付，订单码是商户在设备上输入金额后生产，每笔订单生成的码都不一样，是一种动态码方案；一种是扫商户收款码进行支付，服务商为每个商户分配和生成唯一的静态码，粘贴到贴纸或者立牌上，这是一种静态码方案。

动态码方案

扫码支付快速接入请参考：https://opendocs.alipay.com/open/repo-020ex6

静态码方案

用户扫商家的码之后进入到商家收款页面，在完成输入金额，点击付款后即可唤起收银台进行支付。商家的收款页面可以是H5页面，也可也是小程序页面，下面是两种实现方案。

●

小程序：接入小程序支付，请参考：https://opendocs.alipay.com/mini/introduce/pay

●

H5页面：线下静态码支付方案，请参考：https://alipay.open.taobao.com/docs/doc.htm?&docType=1&articleId=105672

用户身份校验

当前校园食堂通过校园卡来控制就餐人员，大家需要有卡才能就餐，这样可以避免社会人员入校就餐，同样在支持手机移动支付后，部分学校食堂也需要能够控制就餐人员，这样就需要对就餐人员的身份进行校验，只有学生、教职工和被允许的访客人员才能通过手机扫码方式进行支付。

如果校园食堂没有校验用户身份的需求，则不需要实现该方案。

解决方案

在的“条码支付”和“扫码支付”流程中先校验用户身份，校验通过后才能创建支付宝交易订单。条码支付流程中需要从用户付款码中解析出支付宝用户的UID（唯一标识），扫码支付（静态码）流程中则需要在打开商户静态码的页面通过用户授权获取到用户的UID，最后跟学校系统中事先获取的用户信息进行关联。

1、首次获取用户UID

●

如果服务商为学校只提供校园团餐的服务，建议将服务包装成“电子饭卡”或者“食堂会员卡”，用户首先需要在食堂扫码领卡，在领卡过程中通过用户信息授权获取用户信息和UID并与学校系统中的人员信息进行校验，校验通过才能领卡成功，同时“电子饭卡”或者“食堂会员卡”可以作为学校食堂门户，可以包括用户消费纪录、食堂菜品展示、在线点餐、储值卡等功能。

电子饭卡和食堂会员卡示例

●

如果服务商为学校提供的是整体智慧校园的服务，包括了教学、教务、餐饮和后勤相关服务，则需要先引导用户访问智慧校园服务，在访问服务时通过用户信息授权获取到用户的信息和UID并进行身份校验，建议通过“电子校园卡”和“校园小程序”作为智慧校园服务的载体和入口。

电子校园卡和校园小程序示例

用户信息授权请参考：https://opendocs.alipay.com/open/289/105656

会员卡请参考：https://opendocs.alipay.com/mini/introduce/card

2、再次获取用户UID

在条码支付和扫码支付两种场景下获取用户UID的方式不一样，下面分别进行介绍。

条码支付

商户扫用户的付款码进行收款，在获取到用户的付款码后，调用支付宝提供的“alipay.user.twostage.common.use（通用当面付二阶段接口） ”接口从付款码中解析出用户的UID。

通用当面付二阶段接口请参考：https://docs.alipay.com/pre-open/api_pre/alipay.user.twostage.common.use

该接口跟“alipay.trade.pay(统一收单交易支付接口)”配合使用，需要注意：

●

通用当面付二阶段接口中pay_pid（商家进行二阶段支付的pid）必须是首次获取用户信息授权时的商家支付宝账户pid

●

alipay.trade.pay接口的extend_params属性中必须设置DYNAMIC_TOKEN_OUT_BIZ_NO，取值必须与alipay.user.twostage.common.use接口sence_no参数赋值保持一致。即：extend_params":{"DYNAMIC_TOKEN_OUT_BIZ_NO":"sence_no的值"}

扫码支付

用户扫商户的商家码进行支付，由于用户已经给学校进行过授权，只需要通过静默授权获取到用户的UID，静默授权不会再出现授权弹窗。

静默信息授权请参考：https://opendocs.alipay.com/open/284/web#%E5%85%B3%E4%BA%8E%20scope%20%E7%9A%84%E8%AF%B4%E6%98%8E

3、校验用户身份

用在支付时获取的用户UID跟首次获取的用户UID进行匹配，关联到用户信息后进行身份校验，判断是否为学生、教职工、被允许的访客和未知人员，最终判断是否允许发起支付，同时根据用户的身份可以延伸出其它的服务，比如教工餐补。

教工餐补方案

教工餐补可以看成是学校为教工发放的优惠券，教工在食堂扫码支付时核销优惠券，享受免单或者只需要支付部分金额，服务商通过支付宝提供的“无资金商户优惠券”产品来实现，整个方案中教工不需要有领取优惠券的流程，而是在扫码支付过程中由后台系统在判断教工身份后进行先发券后支付核销。如果要对来访的人员进行补贴，也可以采用该方案，将补贴对象放入补贴人员名单并设置补贴金额等规则即可。

餐补模式

学校教工餐补形式很多，建议服务商引导学校使用标准化的补贴方案，避免为每个学校都开发不同的补贴方案，下面列举了三种比较常见的形式，供大家参考。

补贴形式

描述

备注

每餐补贴固定金额

例如一日三餐，每餐补贴10元，单餐有效，过期作废

每日补贴固定金额

例如每日补贴30元，当日有效，过期作废

每月补贴固定金额

例如每月补贴600元，按月发放，可累计

实现方案

每种餐补形式的实现方案基本上都差不多，下面将实现方案分成下面三个关键部分供大家参考。

无资金商户优惠券介绍：https://opendocs.alipay.com/mini/introduce/freevoucher

1、建立餐补名单和账户

●

服务商需要根据学校的教职工名单建立补贴账户，并根据补贴形式配置对应的补贴规则

●

调用无资金商户优惠券接口创建优惠券模板，优惠券模板的金额包括固定面额的优惠券，和不固定面额的优惠券，在这里选择创建不固定金额的优惠券模板，这样可以发放认意金额的优惠券

●

创建优惠券模板接口：alipay.marketing.cashlessvoucher.template.create（无资金券模板创建接口）

2、校验身份并实时发券

●

在用户发起支付的流程中获取到用户的UID（参考用户身份校验部分），通过UID关联到教职工和对应的补贴账户

●

结合账户的补贴规则，判断发放优惠券的金额，如果账户内有效补贴金额大于订单金额，则发放跟订单金额相等的全额优惠券，如果账户内有效补贴金额小于订单金额，则发放跟有效补贴金额相等的优惠券

●

发放优惠券接口：alipay.marketing.voucher.send（发券接口）

3、核销并统计核销数据

●

在支付宝的支付流程中，用户名下的无资金优惠券会被核销掉，实现补贴效果

●

优惠券核销后可以接收到券核销的异步通知，系统需要对核销的用户、优惠券信息进行纪录，用于统计分析优惠券核销数据

扫码设备接入

如果服务商的扫码设备需要享受行业的设备激励政策，扫码设备必须要先接入支付宝IoT平台，否则支付宝无法对设备进行返佣统计。扫码设备接入IoT平台有两种对接方式，一种是在设备上植入IoT SDK，通过SDK上报设备状态，一种是不需要在设备上植入IoT SDK，服务商通过服务端接口上报设备状态，服务商根据设备性能和OS来选择接入方式。

IoT SDK接入

设备接入IoT SDK可以简单分为下面几个关键步骤，具体的接入细节请参考详细的接入文档。

1、设备入驻蚂蚁物料平台

设备供应商需要将设备入驻到蚂蚁物料平台，进行设备厂商和设备信息录入。

设备入驻流程请参考：https://alipay.open.taobao.com/docs/doc.htm?spm=a219a.7629140.0.0.53be4b70R97fKU&treeId=710&articleId=118907&docType=1

2、设备植入IoT SDK

设备植入IoT SDK，用于保障交易安全、管理设备信息以及上报交易数据。

IoT SDK开发文档请参考：https://opendocs.alipay.com/open/00i3kl

3、对交易进行加签

对设备上的交易信息进行签名，完成交易和设备的关联，用于支付宝统计数据用于返佣。

交易加签请参考：https://opendocs.alipay.com/open/00j5tc

4、创建门店

服务商登录开放平台，在运营中心替学校（商户）创建门店，创建的门店需要在审核成功后得到门店的ID。

创建门店时需要注意下面的对应关系：

业务场景

门店类目

收款主体为学校

高校选择：

●

团餐

中小学选择：

●

K12

教育-学校-大学-校园食堂

教育-学校-高职-校园食堂

教育-学校-技校-校园食堂

教育-学校-中专-校园食堂

教育-学校-高中-校园食堂

教育-学校-初中-校园食堂

教育-学校-小学-校园食堂

收款主体为餐饮公司

美食-团餐-校园团餐-大学

美食-团餐-校园团餐-职业技术学院

美食-团餐-校园团餐-中职

美食-团餐-校园团餐-高中

美食-团餐-校园团餐-初中

美食-团餐-校园团餐-小学

*中职学校如果选择中职则享受高校行业政策政策，如果选择高中，则享受中小学行业政策

5、将设备绑定到门店

需要将设备跟门店进行绑定，建立“设备->服务商->商户->门店”的关系，用于支付宝统计数据用于返佣。

设备绑定请参考：https://opendocs.alipay.com/open/11122/huk9w4

更加具体和详细的接入文档请参考：

校园、团餐、K12行业IOT接入SOP通用指南：https://alipay.open.taobao.com/docs/doc.htm?spm=a219a.7629140.0.0.53be4b70R97fKU&treeId=710&articleId=118907&docType=1

IoT SDK开发文档：https://opendocs.alipay.com/open/11428/loo9r7

IoT设备绑定解绑接入文档：https://opendocs.alipay.com/open/11122/fa3cmg

云端接入

云端接入主要针对无法植入IoT SDK的设备，服务商通过服务端接口来上报设备的状态和行为数据，完成交易和设备的关联，用于支付宝统计数据用于返佣。跟“IoT SDK接入”的流程基本一致，只是在设备不需要植入IoT SDK，同时也不需要在设备端对设备进行加签，但需要在创建支付订单时需要传入：

●

alipay_store_id：审核通过的门店ID

●

terminal_id：设备注册时生成的唯一标识

详细接入文档请参考：

IoT设备绑定解绑接入文档：https://opendocs.alipay.com/open/11122/fa3cmg

商家入口

商家入口是服务商提供给到学校食堂（商户）查看交易详情的地方，建议服务商用支付宝小程序来实现商家入口，便于跟支付宝提供的商家服务和商业变现服务打通。