必须同步更新密钥、商户资质和回调地址三类配置,漏改任意一项都会导致支付失败或回调丢失;个人账户不可用,须为个体工商户或企业主体,且密钥、AppID、商户号等均需在对应平台确认“已生效”,回调地址须重填并验证白名单,最后关闭沙箱模式并强制发布生产版本。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要把函子Zion上已跑通的支付功能从沙箱测试切换到支付宝或微信的正式收款环境,必须同步更新密钥、商户资质和回调地址三类配置,漏改任意一项都会导致支付失败或回调丢失。
确认正式商户资质已全部生效
登录支付宝商家中心(https://www.php.cn/link/fb77fa236d1bb1ce3973d53b8576c3eb)和微信商户平台(https://www.php.cn/link/66cadef07c67a314389a824fd8fa0cd1),分别核对:商户号(PID)、AppID、API密钥(微信)或私钥/公钥(支付宝)是否已完成实名认证并显示“已生效”状态。个人账户无法开通正式收款,【必须是个体工商户或企业主体】,否则Zion后台即使填入密钥也无法通过校验。
支付宝特别注意:商家中心只管收钱,密钥必须在开放平台(https://www.php.cn/link/eba9940b6dcffe49a14de9a4899ab466)生成并上传公钥;微信则需在商户平台“API安全”页手动设置APIv3密钥。
替换Zion项目中的支付密钥
进入Zion项目后台 → 设置 → 支付配置 → 对应渠道(微信/支付宝)→ 点击“编辑”:
微信支付:覆盖填写AppID、商户号、APIv3密钥(32位字符串,不是API密钥);
支付宝:覆盖填写AppID、商户PID、应用私钥(PKCS8格式,以-----BEGIN PRIVATE KEY-----开头)、支付宝公钥(由开放平台返回);
【切勿复用沙箱密钥】——沙箱密钥与正式密钥完全隔离,混用会导致签名失败,支付请求直接被拒。
更新行为流中的订单创建逻辑
打开Zion行为流模块 → 找到“创建订单”行为流 → 编辑输出参数:
① 将测试金额(如0.01)改为真实商品价格字段或固定定价逻辑;
② 检查商品描述字段是否含敏感词(如“测试”“demo”),正式环境支付宝会拦截含此类词汇的支付请求;
③ 确保订单ID生成规则符合长度与字符要求(微信要求32位内,支付宝建议28位以上且不含特殊符号);
这一步操作起来很简单,直接修改字段映射即可,但若跳过第②步,上线后可能遭遇静默失败——用户点支付没反应,日志里也查不到错误。
重配支付回调地址并验证白名单
方法一:微信支付
在微信商户平台 → 产品中心 → 开发配置 → 修改“支付回调URL”,填入Zion自动生成的正式域名回调地址(格式为 https://your-app-name.zion.functorz.com/api/v1/payment/wechat/notify),保存后微信会发起GET探测请求,Zion需返回200。
方法二:支付宝
在支付宝开放平台 → 应用详情 → 开发设置 → 回调地址,填入Zion提供的正式回调地址(https://your-app-name.zion.functorz.com/api/v1/payment/alipay/notify),同时在“服务器异步通知”白名单中添加Zion服务器IP段(Zion控制台→项目设置→安全中心可查)。
注意:沙箱回调地址与正式回调地址完全不同,不能仅靠开关切换,必须手动重填并保存。
关闭沙箱模式并发布新版本
回到Zion支付配置页 → 取消勾选“启用沙箱环境” → 点击右上角“发布”按钮 → 选择“强制更新生产环境”。
这一步不可逆,发布后所有前端支付请求将直连正式通道。发布完成即刻用真实手机号下单测试,不要等第二天——正式环境审核通过后资金T+1结算,但首笔交易必须人工验证成功。











