小程序平台如何配置？
更新时间：2026-09-19
以下教程以微信小程序（目前应用最广泛的小程序），演示如何进行各项配置。
一、注册小程序帐号
（1）前往 https://mp.weixin.qq.com/ 注册一个微信小程序的帐号。
（2）填写好各项信息，完成注册。注意：微信支付（JSAPI）需要企业或个体户资质，个人主体无法开通。
二、完成小程序的基础设置与备案
点击「小程序设置-基本设置」，填写小程序的名称、简介、图标等信息，并根据微信要求完成小程序备案。备案通过后才能进行后续的开发和配置。
三、获取小程序的接口信息
「小程序管理-开发管理-开发者ID」，获得小程序的 AppID 和 AppSecret，并填写至网站后台。
四、配置服务器域名
「小程序管理-开发管理-服务器域名」，将 request 合法域名设置为「https://ssl.vfaka.com」
五、微信支付配置
威发卡小程序系统，需要用到微信支付功能，微信支付需企业/个体户资质，需准备营业执照。
（1）如果您已有微信商户，仅需关联小程序APPID账号即可进行收款。设置地址：https://pay.weixin.qq.com/index.php/extend/pay_setting/ma，点击「APPID授权管理-关联更多APPID」，填写小程序的 APPID 即可完成关联。
（2）如果您没有微信商户，需要注册申请，然后进行小程序APPID账号关联。注册地址：https://pay.weixin.qq.com/。
（3）后台设置-收款设置-勾选微信支付并填写微信支付收款相关参数
APP/小程序-微信小程序-支付方式-选择微信支付(JSAPI)
保存后小程序即可实现支付收款功能。
—— 以上为传统 JSAPI 支付方案（商户号关联小程序 AppID 即可收款） ——
▼ 以下为小程序虚拟支付（xpay）方案 ▼
六、小程序虚拟支付（小程序内购）
微信小程序平台 → 支付与交易 → 虚拟支付 → 开通虚拟支付 （企业、个体户、个人均可开通）
如需使用微信小程序虚拟支付（xpay），还需额外配置：
（1）在「虚拟支付 → 基本配置」中查看 OfferId，并获取 AppKey（调用虚拟支付接口的密钥）
（2）配置代币兑换比例：1元人民币 = N代币，须与网站后台一致（三选一：1:100 / 1:10 / 1:1）
（3）代币名称（如"金币"或"余额"）→ 填什么都不影响支付。小程序端账号充值走代币模式，需用代币配置的比例。商品/文章下单走道具直购，跟微信的代币配置无关。
七、配置消息推送
虚拟支付的发货回调需要微信主动通知你的服务器，所以要在这里配置。
入口：小程序公众平台-开发管理 → 开发设置 → 消息推送(启用)
| 配置项 | 填写内容 |
|---|---|
| URL | https://你的域名/api/wxpay/xpay_notify.php |
| Token | 点右侧「随机生成」即可 |
| EncodingAESKey | 自动生成即可 |
| 消息加密方式 | 明文模式 |
| 数据格式 | JSON |
| 除 URL 需要填你的域名外，Token、EncodingAESKey 都点「随机生成」，加密方式选明文、数据格式选 JSON，保存即可 |
保存后微信会立即校验 URL，通过即表示配置成功。商品虚拟支付（xpay_goods_deliver_notify）和充值虚拟支付（xpay_coin_pay_notify）回调都经此推送。
八、后台商品道具同步至小程序
微信小程序虚拟支付只允许交易在它后台登记过的虚拟商品，这些商品在微信侧统一叫「道具」；所以必须先把商品同步过去，微信才认可并放行该商品的虚拟支付交易。
进入后台 内容管理 → 小程序道具管理，找到要卖的商品，点右侧的「同步」。系统会自动把该商品上传到微信小程序后台的虚拟支付-道具配置，并发布到线上版本；同步成功后状态变为「已同步」。稍等片刻待微信侧生效，小程序端就能通过虚拟支付完成已同步的商品的购买交易。
道具商品同步到微信小程序-线上道具后会一直保留，而当商品价格或名称改动后，需要点「重新同步」刷新；正式环境和沙箱环境的道具互不相通，切换后需重新同步一遍。
同样的操作也适用于「文章道具」标签页，文章类商品也走这一个入口。
九、威发卡小程序虚拟支付配置清单
| 配置项 | 填写内容 |
|---|---|
| 微信小程序-AppID | 从微信小程序后台获取 |
| 微信小程序-AppSecret | 从微信小程序后台获取 |
| 虚拟支付 OfferId | 微信小程序-虚拟支付获取 |
| 虚拟支付 AppKey | 微信小程序-虚拟支付获取 |
| 虚拟支付环境 | 正式环境 / 沙箱环境 |
| 支付方式 | 自动（优先虚拟支付，未配置则回退微信支付JSAPI）/ 小程序虚拟支付 / 微信支付(JSAPI) |
| 充值档位 | 快捷充值按钮金额，如 10,30,50,100,200 |
| 代币兑换比例 | 与微信小程序-虚拟支付-代币配置一致（1:100 / 1:10 / 1:1） |
| 道具同步 | 网站后台-小程序道具管理-商品道具同步/文章道具同步 |
十、上线验证清单
| 验证项 | 操作说明 |
|---|---|
| JSAPI | 后台切换为JSAPI支付，买一件商品，支付后能正常显示发货内容 |
| 虚拟支付 | 后台切换成虚拟支付，购买一件已同步的商品，支付后能正常显示发货内容 |
| 充值 | 充值一笔，余额实时到账 |
| 后台核对 | 订单显示「已发货」，资金流水有对应记录 |
| 环境切换 | 可先用沙箱环境测通，再切换正式环境 |
十一、常见问题排查
| 现象 | 排查方向 |
|---|---|
| 购买后发货界面空白 | 检查订单是否创建、回调是否执行；后台订单是否有记录 |
| 充值不到账 | 虚拟支付：检查消息推送配置（事件 xpay_coin_pay_notify）能否解析到用户和金额 |
| 收不到任何回调（JSAPI） | 检查收款设置的商户号参数是否正确，回调地址为 api/wxpay/notify_url.php |
| 收不到任何回调（虚拟支付） | 检查消息推送 URL 是否指向 xpay_notify.php，Token、明文模式、JSON 格式是否正确 |
| 充值提示比例不一致 | 把微信后台的代币兑换比例，改成和网站后台「代币兑换比例」相同 |
