- 简单介绍：DouPHP 支付宝当面付插件：面向线下门店，支持买家扫商家二维码付款（正扫）与商家用扫码枪扫买家付款码扣款（反扫）两种模式。需在支付宝开放平台签约"当面付"产品并获取 AppID、应用私钥与支付宝公钥。
- 编号： 分类： 开发者：DouCo Co.,Ltd 更新时间：2026-09-28 下载量：94
- **插件简介：** 面向线下门店的扫码 / 条码支付方案，支持买家扫商家二维码付款（正扫）与商家用扫码枪扫买家付款码实时扣款（反扫）两种模式，兼顾自助收银与人工收银台。
**申请准备：** 需企业支付宝账号并在支付宝开放平台创建"自研者 - 当面付"应用完成签约；个人账号仅能申请"小额当面付"且单笔限额较低，正式门店建议使用企业主体。
**需要获取的凭据：**
1. AppID：应用详情页显示，代表门店对应的支付宝应用。
2. 应用私钥：使用官方「支付宝开放平台助手」生成 RSA2 密钥对后本地保存。
3. 支付宝公钥：上传应用公钥后由开放平台生成，用于验签回调内容。
4. 门店 POS 或扫码枪：如需反扫模式必须配备硬件设备。
**在 DouPHP 中的启用与配置：**
1. 安装插件：后台 → 插件扩展 → 安装插件，在 DouPHP 官方插件列表按名称找到「支付宝-当面付」→ 点击「安装」；系统自动从 douphp.com 抓取插件包并部署到 `include/plugin/alipayf2f/` 目录
2. 启用与配置：返回后台 → 插件扩展 → 管理插件，在已安装列表定位到「支付宝-当面付」→ 点击「启用」即进入插件配置页 → 按上文要求依次填入 PID / KEY / APPID / 公钥 / 回调地址等凭据 → 保存
3. 停用与卸载：仍在管理插件页，对该行点「停用」临时关闭前台入口；点「删除」会连同该插件的配置数据一并移除，谨慎操作
**常见问题：** 报"PAYMENT_FACE_TO_FACE_AUTH_FAIL"多为反扫权限未申请；报"ACQ.QUERY_ACQ_ERROR"一般是网络抖动可稍后重试；单店多终端并发时建议限流并统一对账时间；离线断网时反扫无法工作，请预留备用付款码。