系统配置
更新时间：2024-09-15
目录
集中维护
为了方便日常配置管理和维护，我们将系统中常用的配置项都集中在【系统设置】-【配置管理】
基本设置
号卡平台网站常规设置，如系统名称、LOGO、访问域名等主要品牌信息
- PC端后台专属客服
PC端后台专属客服，开启后所有代理商可见
- 平台选择
| 名称 | 编码前缀 | 描述 | 操作 |
|---|---|---|---|
| 53快服 | 53kf@ | 18 年专注客服系统 | 对接文档 |
| 知你 | zhini@ | 高效微信公众号营销管理工具 | 对接文档 |
开通后请将对应平台的渠道ID配置到
平台客服渠道ID,格式：编码前缀 + 平台客服渠道ID，如：53kf@eyJpdiI6Ik96OVdid0FEVTJhZ01
签约认证
代理商实名认证和在线电子合同签约，合同内容和认证规则配置
注意
系统搭建后请务必将各项信息以及电子合同模板修改成你自己的
- 审批 代理商提交实名认证和电子签约合同后，总站工作人员可以在【系统设置】-【签约合同】中进行审批
通过个人审批 个人代理商，只需要阅读确认签约事项，提交本人的身份证信息即可通过验证
通过企业审批 企业代理商需要上传营业执照、法人的身份证、下载电子合同模板签字后回传扫描件。总站审核通过后需要将代理商已签字的电子合同下载补填签字并回传合同。由此代理商可在其后台中下载完整签约合同
- 审核未通过 若审核不达标准，可以拒绝并附带审核未通过原因，代理商可以重新提交申请
下游配置
下游默认价格设置和分销模式，在这里可以控制全平台新注册代理商的默认佣金差价。
这里还可以为下游代理商开放超级会员功能
超级会员
功能作用： 为了更大限度满足不同场景下的下游佣金需求，让总站有更灵活的佣金运营策略
- 总站上架商品时除了设置基本的佣金基数以外，额外设有【超会追加佣金】选项，全站代理商均可由总站决定是否为其开通
- 总站可以在【下游管理】中将指定下游设为/取消【超级会员】
- 【超级会员】在完成订单时可以获得【超会追加佣金】
- 下游升级到【超级会员】后，在此之前的订单佣金不变；下游取消【超级会员】后，在此之前产生订单的【超会追加佣金】也不变
超级会员生效条件
| 序号 | 说明 |
|---|---|
| 1 | 【下游配置】中【超级会员总开关】已开启 |
| 2 | 下游已被总站设置为【超级会员】 |
| 3 | 上架商品设置了有效的【超会追加佣金】 |
| 4 | 以上条件都满足的情况下，下游在产出订单时，会在其订单佣金中增加【超会追加佣金】 |
以下在总站下游管理列表中的一些效果，点击下游卡片中的【超级会员】标签可以开关下游的超会状态
开通超级会员后，下游后台会展示【超级会员】标识。未开通则什么都不显示
开通超级会员后下游的【在售商品中心】展示效果
开通超级会员后下游的【订单处理】展示效果 
邮件设置
系统邮件设置，用于商品下架通知、提现到账通知等
- 推荐邮箱服务器
- 发送测试邮件
如果能收到邮件，则说明邮箱服务器配置成功，否则请检查配置项哪里不对
- 常见问题
- 配置后提示
535 Authentication failure[0] [@ud010201]，一般是你的邮箱服务器账号或密码配置不正确 - 发送后
长时间无响应或提示EOF,一般是SMTP服务器或端口配置不正确，确认后可以尝试切换端口：25,465,587
短信配置
短信验证码平台，用于短信验证码登录注册、下单订单进度通知
- 可选短信服务
| 名称 | 描述 | 获取文档 |
|---|---|---|
| 阿里云 | 短信服务 | https://help.aliyun.com/zh/sms/getting-started/get-started-with-sms |
| 腾讯云 | 短信 | https://cloud.tencent.com/document/product/382 |
- 短信模板示例
以下示例只作为格式参考，可以根据你实际情况编写短信内容文案。模板申请通过后请填写到事件KEY对应的模板ID中
| 名称 | 类型 | 事件KEY | 模板内容 |
|---|---|---|---|
| 通用验证码 | 验证码 | code | 您的验证码：${code}，有效期10分钟，如非本人操作，请忽略本短信！ |
| 登录 | 验证码 | login | 您正在登录xx号卡系统，您的验证码：${code}，有效期10分钟，如非本人操作，请忽略本短信！ |
| 注册 | 验证码 | register | 您正在注册xx号卡系统，您的验证码：${code}，有效期10分钟，如非本人操作，请忽略本短信！ |
| 重置密码 | 验证码 | resetPwd | 您正在重置密码，您的验证码：${code}，有效期10分钟，如非本人操作，请忽略本短信！ |
| 绑定手机号 | 验证码 | bind | 您正在绑定手机号，您的验证码：${code}，有效期10分钟，如非本人操作，请忽略本短信！ |
| 申请提现 | 验证码 | cash | 您正在申请提现，您的验证码：${code}，有效期10分钟，如非本人操作，请忽略本短信！ |
| 申请订单 | 验证码 | applyOrder | 您正在申请订单，您的验证码：${code}，有效期10分钟，如非本人操作，请忽略本短信！ |
| 发货成功 | 营销短信 | sendSuccess | 尊敬的 ${name}，恭喜下单成功！您的快递已飞奔在路上，单号为${number}，请留意查收。 |
| 审核失败 | 营销短信 | verifyFail | 尊敬的${name}，非常抱歉，您办理的卡发货失败了，详询商家/店铺处理。 |
| 提现成功 | 营销短信 | cashSuccess | 尊敬的${name}代理商，您的提现申请已到账，请留意查收。 |
登录注册
登录注册配置，登录页封面、注册协议、注册开关、微信登录配置
提现配置
管理员提现规则配置，配置无票、普票、专票多费率提现，提现申请规则
云存储
配置上传文件驱动，为商品图片资源、用户头像、签约合同文件、静态文件资源等提供加速访问支撑
- 可选驱动
| 名称 | 描述 | 获取文档 |
|---|---|---|
| 本地驱动 | 本地服务器 | 若服务器宽带低于10M，不推荐使用 |
| 阿里云 | OSS | https://help.aliyun.com/zh/oss/getting-started/?spm=a2c4g.11186623.0.0.27e47368Tw2wbV |
| 腾讯云 | COS | https://cloud.tencent.com/document/product/436 |
| 七牛云 | 对象存储 | https://developer.qiniu.com/kodo |
| ucloud | 对象存储 US3 | https://docs.ucloud.cn/ufile/README |
- 上传测试
配置完成后，可以在【系统应用】-【附件管理】中进行上传测试
地理位置
配置地理位置工具，为导入订单自动识别收货省市区编码、选号地区编码
登录高德开放平台，进入【应用管理】-【创建新应用】-填写应用名称，设置服务平台为：Web服务,其他使用默认选项即可。
创建完整后将key复制保存到后台地理位置配置中的高德Web服务key即可
支付配置
支付宝/微信/QQ支付配置等。当商品开启价格后，需要进行配置，否则可以忽略。如果你是托管系统，请联系客服协助完成此配置
支付宝
- 产品权限开通
需要开通电脑网站支付、手机网站支付，参考地址：https://b.alipay.com/page/product-mall/product-detail/I1080300001000041949
- 证书生成
1. 下载支付宝平台密钥工具（下载地址：`https://opendocs.alipay.com/common/02kipk`），加签方式选择证书，加密算法选择RSA2
2. 生成后的私钥请在工具中转换为PKCS1格式
3. 在支付宝中配置证书，参考地址：`https://opendocs.alipay.com/common/02khjo?pathHash=5403bedd`
4. 证书请覆盖上传到服务器的目录（如果不存在就手动创建下）：`/root/haoka/haoka/storage/cert/pay/alipay`注意
注意证书文件名称需要和后台保持一致，支付宝私钥通过工具生成好以后是一段密文，需要手动创建一个文件：alipayPrivateKey，将内容粘贴进去，注意不要有多余空格，注意如果默认创建的文件类型是.txt要将.txt去掉
后台默认路径配置，非必要不建议修改：
| 名称 | 路径 |
|---|---|
| 应用私钥路径 | storage/cert/pay/alipay/alipayPrivateKey |
| 应用公钥 | storage/cert/pay/alipay/appCertPublicKey.crt |
| 支付宝根证书路径 | storage/cert/pay/alipay/alipayRootCert.crt |
| 支付宝公钥证书路径 | storage/cert/pay/alipay/alipayCertPublicKey_RSA2.crt |
微信支付
- 需要开通
JSAPI支付
- 同时需要绑定一个微信公众号，并将公众号配置到
微信配置 - 到
登录注册配置中开启微信静默登录或授权登录
微信配置
公众号/开放平台/小程序配置等。如果你是托管系统，请联系客服协助完成此配置
公众号
- 配置AppID、AppSecret
- 绑定网页授权域名
请将验证文件上传到服务器的目录：/root/haoka/haoka/resource/public，这也是号卡系统的根目录
注意
此处的域名必须和你号卡系统总后台域名保持一致！
- 配置白名单
模板消息推送
公众号支持为平台企业人员和代理商推送重要消息，通过配置模板消息来实现。
- 开通公众号模板消息功能。登录微信公众号-新的功能，找到模板消息，根据引导进行开通即可
提示
这里因为通讯行业类目需要有营运商授权资质要求，为了保证更多平台可以使用到本功能，如果你没有资质可以申请不需要资质的类目，在后续添加模板时寻找相似的模板也可以使用
申请通过后,到广告与服务-模板消息中添加需要的模板格式。平台支持多种消息格式，按需要配置开启即可
添加模板时，注意模板中的变量尽量和系统模板是相匹配的，不要使用常量变量
将添加好的模板在后台进行关联，后台模板中的变量如果不需要用到不填即可
全部配置好以后，模板消息就会在相应的事件节点中触发推送消息给平台用户
如何接收消息推送？
在PC端或商户端绑定微信登录并关注公众号即可
PC端
商户端
提示
如果你不想让代理商使用此功能或不方便为全部代理商展示微信公众号二维码时，只需在【系统配置】-【微信配置】-【公众号】留空公众号二维码，则相关关注公众号功能就会自动隐藏
开放平台
暂时不需要配置
小程序
暂时不需要配置
协议管理
用户下单/代理商协议，根据不同运营商展示不同的下单协议内容