一、下载商品配置流程

1. 开启下载功能基础设置

• 路径：后台管理界面 → 商店设置 → 属性设置

• 关键操作：

• 将允许下载设为True，启用系统下载功能。

• 设置重定向下载为True，确保下载链接安全有效。

• 配置下载控制订单状态值（如设置为“处理中”状态），控制用户下载权限。

2. 创建下载项选项

• 路径：后台管理界面 → 商品管理 → 选项类型管理

• 操作步骤：

• 新增选项类型为单选，输入名称（如“版本”）。

• 进入选项内容页面，添加具体下载格式（如“Windows Zip格式”“PDF格式”），并设置排序值。

3. 新增商品并关联下载

• 路径：后台管理界面 → 商品管理 → 商品分类 → 新商品

• 操作步骤：

• 填写商品基本信息（可设为虚拟商品）。

• 进入属性控制页面，选择之前添加的下载选项（如“版本”→“Windows Zip格式”）。

• 在可下载商品部分输入文件名（如manual.zip），注意大小写敏感。

• 通过FTP上传文件至/catalog/download目录，确认文件路径正确后点击增加。

• 

二、支付方式配置流程

1. 安装支付模块

• 路径：后台管理界面 → 模块管理 → 支付模块

• 操作步骤：

• 点击安装按钮加载支付插件（如PayPal、Stripe）。

• 若使用第三方支付网关，需上传插件文件至/includes/modules/payment/目录。

2. 配置支付参数

• 关键设置项：

• 启用模块：设为True激活支付方式。

• 账户类型：选择Live（正式环境）或Sandbox（测试环境）。

• 支付模式：根据账户类型选择（如个人账户仅支持Sale，商业账户支持全部模式）。

• API密钥：输入支付网关提供的密钥（如Stripe的Secret Key）。

• 回调URL：设置为支付网关要求的地址（如https://yourstore.com/ipn_main_handler.php）。

3. 设置订单状态关联

• 延迟下载配置：

• 将支付方式（如邮局汇款）的订单状态设为等待中(1)，用户付款后手动确认。

• 立即下载配置：

• 将支付方式（如信用卡、PayPal）的订单状态设为处理中(2)，付款成功后自动触发下载权限。

4. 测试支付流程

• 沙盒环境测试：

• 使用支付网关提供的测试账户模拟交易，验证支付成功后的订单状态变更和下载权限开放。

• 日志排查：

• 检查/logs/目录下的错误日志，或通过支付网关后台查看交易详情，定位失败原因。

三、典型支付方式配置案例

案例1：PayPal标准支付配置

1. PayPal账户设置：

• 登录PayPal后台，启用即时付款通知(IPN)，设置通知URL为https://yourstore.com/ipn_main_handler.php。

• 在网站付款偏好设置中开启自动返回，设置返回URL为https://yourstore.com/index.php?main_page=checkout_process。

2. Zen Cart后台配置：

• 安装PayPal IPN模块，输入PayPal账户邮箱。

• 设置订单状态为处理中(2)，确保付款后自动开放下载。

案例2：Stripe支付配置

1. 文件部署：

• 在/includes/modules/payment/下创建c_stripe文件夹，上传c_stripe.php主模块文件。

• 在/languages/english/modules/payment/下创建同名语言文件，定义支付模块标题和描述。

2. API配置：

• 在Stripe后台获取API密钥，填入Zen Cart后台的Stripe模块配置页。

• 设置回调URL为https://yourstore.com/checkout_process，传递支付结果数据。

四、常见问题与解决方案

1. 下载链接失效

• 原因：文件未上传至/catalog/download目录，或文件名大小写不匹配。

• 解决：检查FTP上传路径，核对文件名拼写。

2. 支付成功后订单未更新

• 原因：支付网关回调URL错误，或Zen Cart订单状态配置冲突。

• 解决：核对回调URL与支付网关设置一致，检查下载控制订单状态值是否匹配。

3. 支付方式不显示

• 原因：模块未启用，或国家/地区限制导致隐藏。

• 解决：在支付模块配置页启用模块，检查Locations → Countries设置。