本套SwapIDC支付宝当面付插件为解密优化版，去除原版授权验证机制，支持原生对接支付宝当面付V2接口。插件基于PHP+OpenSSL开发，适配SwapIDC V3.2及以上版本，实现免授权快速集成移动支付功能。

一、技术架构核心特性

1. 代码结构解析

• 原加密方式：采用IonCube 10.3加密（现全面解密为可读PHP源码）

• 核心文件构成：

• alipay.func.php：支付SDK主逻辑（包含RSA2签名验证）

• swapidc_hook.php：SwapIDC系统钩子文件（监听订单状态变更）

• notify_url.php：支付宝异步通知处理接口

2. 支付宝接口对接

• 接口版本：当面付V2接口（文档参照支付宝开放平台2023版）

• 通信协议：

• 请求编码：UTF-8

• 签名算法：SHA256WithRSA

• 证书配置路径：/cert/alipay/（需放置appCertPublicKey.crt等文件）

3. SwapIDC适配方案

• 钩子事件类型：

• onOrderCreate：订单生成时触发支付请求

• onOrderPaid：支付成功后更新服务状态

• 数据库字段扩展：

• 新增trade_no字段存储支付宝交易号

• 增加payment_log表记录支付回调数据

二、插件功能模块拆解

1. 核心功能实现

• 支付方式挂载：在SwapIDC后台「支付方式」中显示「支付宝当面付」选项

• 金额精度处理：自动将元单位转换为分单位（如19.99元→1999分）

• 订单超时机制：30分钟未支付自动关闭交易（触发SwapIDC订单回收）

2. 安全防护机制

• 异步通知验证：

• 校验支付宝公钥证书有效性

• 双重验证商户ID(app_id)与订单金额

• 防重复通知：通过trade_no+out_trade_no组合去重处理

3. 日志监控体系

• 日志存储路径：/runtime/logs/alipay/（按日期分割日志文件）

• 关键日志内容：

• 请求参数明文记录

• 签名验证过程跟踪

• 异步通知原始数据

三、插件部署实施流程

1. 环境预检与准备

• PHP版本要求：7.1-7.4（禁用高危函数：exec、system）

• 扩展依赖检查：

  php -m | grep openssl   # 需返回openssl  php -m | grep curl      # 需返回curl

  运行

• SwapIDC版本确认：登录后台查看「系统信息」≥V3.2

2. 插件安装步骤

• 上传文件至指定目录：

  /plugins/alipay/         # 主插件目录  
  /includes/hooks/         # 钩子文件目录

• 导入SQL结构（仅首次安装需要）：

  ALTER TABLE `orders` ADD `trade_no` VARCHAR(32) DEFAULT '';  
  CREATE TABLE `payment_log` (...);

3. 支付参数配置

• 修改alipay_config.php：

  $config['app_id'] = '202100xxxxxxx';  
  $config['merchant_private_key'] = 'MIIEowIBAAKCAQEAtJkq...';  
  $config['alipay_public_key'] = 'MIIBIjANBgkqhki...';

• 设置支付宝公钥证书：

• 将appCertPublicKey.crt、alipayRootCert.crt上传至/cert/alipay/

• 文件权限设置为644

4. 功能验证流程

• 沙箱环境测试：

• 修改alipay_config.php中$config['is_sandbox'] = true;

• 使用支付宝沙箱账号完成模拟支付

• 生产环境切换：

• 关闭沙箱模式

• 在SwapIDC后台启用支付方式