商城系统与支付配置

2026-11-21 · 浏览 2

第八章 商城系统

8.1 商品与订单

  • 「商品管理」:上架商品(价格 / 库存 / 图集 / 详情),内容模型可标记为商品
  • 「订单管理」:查询 / 发货 / 关闭订单;订单明细含商品快照

8.2 配送与优惠

  • 「配送方式」:运费模板(按重量 / 固定)
  • 「优惠码」:生成兑换码,下单抵扣

8.3 支付配置实操

支付流程总览

会员下单 → 跳转 /pay/go?no=订单号 → 按订单支付方式选择网关
  ├─ 已配置凭据:跳转真实网关(支付宝收银台 / 微信二维码页 / 表单网关)
  └─ 未配置凭据:自动回退 Mock 模拟收银台(/pay/mock?no=订单号)
支付完成 → 异步回调 /pay/notify/{渠道} 验签入账(幂等,可重试)
同步回跳 → /pay/back 显示支付结果页
  • 单号自动分流:商城订单与充值订单(RC 前缀)共用同一支付入口,回调按单号识别后分别入账
  • 后台「商城管理 → 支付设置」为只读状态页:展示各渠道配置状态(已配置 / 未配置)、支付宝网关模式(正式 / 沙箱)、自动生成的回调地址与 .env 配置指引;真实凭据只配在 .env,不入库、不进后台

支付宝(电脑网站支付 page.pay,RSA2)配置步骤

  1. 支付宝开放平台(open.alipay.com)创建应用并签约「电脑网站支付」产品,获得 APPID
  2. 用官方「密钥工具」生成 RSA2 密钥对,将应用公钥填入开放平台应用配置后,页面会生成支付宝公钥(注意:.env 里要填的是这串"支付宝公钥",不是自己的应用公钥)
  3. 编辑站点根目录 .env:
PAY_ALI_APP_ID=2021001234567890
PAY_ALI_PRIVATE_KEY=(应用私钥:推荐单行 PEM,去掉 -----BEGIN/END----- 头尾与换行;也支持完整多行 PEM 粘贴,PKCS8 / PKCS1 均可)
PAY_ALI_PUBLIC_KEY=(支付宝公钥)
PAY_ALI_GATEWAY=https://openapi.alipay.com/gateway.do
PAY_ALI_NOTIFY_URL=https://你的域名/pay/notify/alipay
PAY_ALI_RETURN_URL=https://你的域名/pay/back
  1. 回调地址可在后台「支付设置」页直接复制(基于 SITE_URL 自动生成)
  2. 沙箱联调:PAY_ALI_GATEWAY 换为 https://openapi-sandbox.dl.alipaydev.com/gateway.do,后台状态页将显示「沙箱环境」徽标
  3. 修改 .env 后重启 PHP-FPM(或等待 Env 缓存刷新)生效;前台创建订单即可验证真实跳转

微信(Native 扫码支付 V2,MD5 签名)配置步骤

  1. 微信商户平台(pay.weixin.qq.com)开通「Native 支付」获得商户号,关联公众号 / 服务号取得 APPID
  2. 「账户中心 → API 安全」设置 APIv2 密钥(32 位)
  3. .env 配置:
PAY_WX_MCH_ID=商户号
PAY_WX_KEY=APIv2密钥
PAY_WX_APPID=公众号APPID
PAY_WX_NOTIFY_URL=https://你的域名/pay/notify/wechat
  1. 下单后前台渲染二维码支付页(weixin://wxpay/...),会员扫码支付,页面自动轮询 /pay/status?no= 检测支付状态,成功后跳转订单列表
  2. 需要后台在线退款时另配商户双向证书:PAY_WX_CERT_PATH / PAY_WX_CERT_KEY_PATH(证书与私钥文件的绝对路径,退款接口必需)

其他渠道(可选)

渠道 .env 键 回调地址
银联在线(全渠道网关) PAY_UNION_MER_ID / PAY_UNION_CERT_PATH(.pfx 绝对路径)/ PAY_UNION_CERT_PWD / PAY_UNION_PUBLIC_KEY_PATH(验签公钥) 异步 /pay/notify/unionpay,同步 /pay/back
易宝支付(YBZFP) PAY_YEEPAY_MER_ID / PAY_YEEPAY_KEY 异步 /pay/notify/yeepay,转接页 /pay/back
PayPal(REST v2) PAY_PAYPAL_CLIENT_ID / PAY_PAYPAL_SECRET / PAY_PAYPAL_MODE(live|sandbox)/ PAY_PAYPAL_CURRENCY(默认 USD,金额数值原样提交需自行换算) 回跳 /pay/back(系统自动 capture 入账)

Mock 模拟支付测试流程(本地 / 未配置凭据时自动启用)

  1. 渠道凭据留空 → 该渠道自动回退 Mock;会员发起支付进入模拟收银台(/pay/mock?no=订单号)
  2. 点击「确认支付」→ 订单立即标记已支付(流水号 MOCK+时间戳),跳回订单列表 / 充值页
  3. 权限:仅订单归属会员本人或管理员可模拟支付;Mock 无异步回调,收银台确认即入账
  4. 建议上线前用 Mock 完整回归:下单 → 支付 → 订单状态流转 → 后台发货,以及点卡 / 在线充值全流程

常见问题排错

现象 原因与处理
提示「支付宝密钥配置无效」 PAY_ALI_PRIVATE_KEY 格式错误:单行裸密钥需去掉头尾标记与换行,或粘贴完整 PEM(含头尾行);PKCS8 / PKCS1 均自动识别
回调 HTTP 400 verify failed PAY_ALI_PUBLIC_KEY 填成了应用公钥——必须填开放平台展示的支付宝公钥;微信侧检查 PAY_WX_KEY 是否为 APIv2 密钥
支付成功但订单未入账 异步回调地址外网不可达(需公网 80/443 可访问);核对 .env 中 PAY_*_NOTIFY_URL 与后台「支付设置」展示地址一致
微信下单失败 商户号与 APPID 未关联、Native 支付未开通、APIv2 密钥错误;具体原因见异常提示中的网关返回信息
回跳页显示未支付但已扣款 同步回跳仅展示结果,入账以异步回调为准;稍候在「订单管理」核对状态
沙箱验签一直失败 沙箱密钥与正式密钥不通用,需使用沙箱应用自己的密钥对

8.4 点卡与充值

  • 「点卡管理」:生成点卡(面值点数),会员充值卡密得点数;商品可用点数购买(buyform)
  • 「充值类型 / 充值记录」:在线充值套餐与流水

页次:1/1 每页1 总数1    首页  上一页  下一页  尾页    转到:
下载乐悠悠CMS 联系我们