通道配置
阐述
通道指第三方提供的接口或服务，如：微信支付、微信小程序
建议配置顺序：文件存储、微信小程序、极光短信、微信支付
目前系统集成的通道服务主要有：微信支付2.0及服务商3.0、微信小程序、微信公众号、阿里云存储、腾讯云存储、七牛云存储、极光短信、秒滴短信、人脸识别、证件识别、快递100
注意：文件存储 和 短信 必须配置路由，其他通道无需配置
通道信息管理【菜单】
所有的三方通道信息将统一在此管理
- 图注1、图注2，可以新增通道信息
- 图注3是列表扩展功能，分别是：显示列、打印列表、导出列表
- 图注4分别为：查看通道详细信息、编辑通道信息、删除通道信息、刷新通道配置
- 默认修改通道配置信息是不做刷新的，全部配置完成点击按钮统一刷新
系统设置 -> 通道管理 -> 通道信息
下图为新增通道信息
- 通道编码必须是已知存在的 通道编码
- 通道商户号通常情况下是：APP ID、商户号等其他名称
能够标识通道唯一的编号 每个通道都不太一样，请参考通道配置
系统设置 -> 通道管理 -> 通道信息 - 新增
通道配置配置【菜单】
- 图注1、图注2可以新增通道配置配置
- 图注3分别为：查看详细信息、编辑
- 每个配置是一条数据，按特定规则通道密钥等配置已做脱敏处理
- 具体配置配置，请参考 通道配置
系统设置 -> 通道管理 -> 通道配置
通道路由配置【菜单】
- 图注1、图注2可以新增通道路由配置
- 图注3：分别为：查看详细信息、编辑
- 图注4：业务类型
文件存储 配置了两个路由 将会按启用且权重高的通道执行 - 目前仅支持：文件存储 和 短信 必须配置路由，其他通道无需配置
系统设置 -> 通道管理 -> 通道配置
通道编码
| 通道名称 | 通道唯一编码 | 备注 |
|---|
| 微信支付V2 | WXPAY | 微信第二版支付接口（支持普通商户及服务商） |
| 微信支付V3 | WXPAY_V3 | 微信第三版支付接口，服务商支付接口已通过，普通商户未测试 |
| 支付宝支付 | ALIPAY | 支付宝支付 |
| LINK FACE | LINKFACE | 人脸识别、四要素认证、身份证图片识别 |
| 百度 | BAIDU | 身份证图片识别 |
| 阿里云短信 | ALIYUN_SMS | 短信需要配置路由 |
| 秒滴短信 | MIAODI | 短信需要配置路由 |
| 极光短信 | JPUSH_SMS | 短信需要配置路由 |
| JC短信 | JCSMS | 短信需要配置路由 |
| 测试短信 | TEST_SMS | 短信需要配置路由，主要用于本地测试用 |
| 微信小程序 | WX_MP | |
| 微信公众号 | WX_GZH | |
| 头条小程序 | TT_MP | |
| 阿里云存储 | ALIYUN_OSS | 存储需要配置路由 |
| 腾讯云存储 | TENCENT_OSS | 存储需要配置路由 |
| 七牛云存储 | QINIU_OSS | 存储需要配置路由 |
| 服务器存储 | LOCAL_OSS | 存储需要配置路由 |
| 快递100 | KT100 | |
| 库存数据拉取 | RC_STOCK | 柒世美专用接口，不开放 |
| 微信视频号 | WX_LIVE | 接口已调完，待实现系统功能 |
| 商家平台 | LLN | |
| 淘宝联盟 | TB_AFF | 暂未实现 |
| 中通快递 | ZTO | 暂未实现 |
| QQ小程序 | QQ_MP | 暂未实现 |
| 支付宝小程序 | ALI_MP | 暂未实现 |
通道配置
微信支付V2-普通商户
| 配置名称 | 配置键 | 配置值实例 | 配置说明 |
|---|
通道编号 | 创建通道时填入 | WXPAY | 创建通道时使用 |
商户号 | 创建通道时填入 | wxd9faa62c96fb33d6 | 商户 AppID(公众号ID) |
| 微信支付商户号 | MCHID | 1610266199 | |
| 微信支付密钥 | PRIVATE_KEY | 5eN0HJlo162H27KiYv89UisTcH | |
| 签名方式 | SIGN_TYPE | MD5 | 固定值 |
微信支付V2-服务商
- 注意：
- 仅SUB_MERCHANT_CODE 和 SUB_MCHID为子商户的配置，其他全部是服务商得配置
| 配置名称 | 配置键 | 配置值实例 | 配置说明 |
|---|
通道编号 | 创建通道时填入 | WXPAY | 创建通道时使用 |
商户号 | 创建通道时填入 | wxd9faa62c96fb33d6 | 服务商的公众号AppID |
| 服务商号 | MCHID | 1606880688 | 微信支付服务商商户号 |
| 服务商密钥 | PRIVATE_KEY | 5eN0HJlo162H27KiYv....TcH | |
| 子商户号 | SUB_MCHID | 1610266199 | 微信支付子商户号 |
| 子商户APP ID | SUB_MERCHANT_CODE | wxf08d832f69ba81c9 | 子商户小程序或公众号AppID |
| 签名方式 | SIGN_TYPE | MD5 | 固定值 |
微信支付V3-服务商
- 注意：
- 仅SUB_MERCHANT_CODE 和 SUB_MCHID为子商户的配置，其他全部是服务商得配置
| 配置名称 | 配置键 | 配置值实例 | 配置说明 |
|---|
通道编号 | 创建通道时填入 | WXPAY_V3 | 创建通道时使用 |
商户号 | 创建通道时填入 | wxd9faa62c96fb33d6 | 服务商的公众号AppID |
| 子商户APP ID | SUB_MERCHANT_CODE | wxf08d832f69ba81c9 | 子商户小程序或公众号AppID |
| 子商户号 | SUB_MCHID | 1610266199 | 微信支付子商户号 |
| 服务商号 | MCHID | 1610266199 | 微信支付服务商户号 |
| 服务商平台证书 | PLATFORM_CERTIFICATE | 非常长 | |
| 服务商证书序列号 | MCH_SERIAL_NO | 1E81073B898FECB0459B3A281B56637A8FC11BC0 | |
| 服务商API密钥 | SECRET_KEY | 5eN0HJlo162H27KiYv670Oq916V43TcH | |
| 服务商私钥 | PRIVATE_KEY | 5eN0HJlo162H27KiYv670Oq916V43TcH | |
| 签名方式 | SIGN_TYPE | RSA | 固定值 |
| 请求报文类型 | CONTENT_TYPE | application/json; charset=utf-8 | 固定值 |
微信小程序
| 配置名称 | 配置键 | 配置值实例 | 配置说明 |
|---|
通道编号 | 创建通道时填入 | WX_MP | 创建通道时使用 |
商户号 | 创建通道时填入 | wxf08d832f69ba81c9 | 开发管理 - 开发设置 ：AppID(小程序ID) |
| 密钥 | PRIVATE_KEY | | 开发管理 - 开发设置 ：AppSecret(小程序密钥) |
| 消息验证Token | token | | 开发管理 - 开发设置（可不填） |
头条小程序
| 配置名称 | 配置键 | 配置值实例 | 配置说明 |
|---|
通道编号 | 创建通道时填入 | TT_MP | 创建通道时使用 |
商户号 | 创建通道时填入 | wxf08d832f69ba81c9 | 开发管理 - 开发设置 ：AppID(小程序ID) |
| 密钥 | PRIVATE_KEY | | 开发管理 - 开发设置 ：AppSecret(小程序密钥) |
微信公众号
| 配置名称 | 配置键 | 配置值实例 | 配置说明 |
|---|
通道编号 | 创建通道时填入 | WX_GZH | 创建通道时使用 |
商户号 | 创建通道时填入 | wxd9faa62c96fb33d6 | 开发管理 - 开发设置 ：AppID(公众号ID) |
| 密钥 | PRIVATE_KEY | | 开发管理 - 开发设置 ：AppSecret(公众号密钥) |
| 消息验证Token | token | | 开发管理 - 开发设置 |
极光短信
短息推荐使用极光短信
- 注意：
- 短信需要配置路由，路径：系统设置 -> 通道管理 -> 通道路由
| 配置名称 | 配置键 | 配置值实例 | 配置说明 |
|---|
通道编号 | 创建通道时填入 | JPUSH_SMS | 创建通道时使用 |
商户号 | 创建通道时填入 | b4ac08399bdeff1605e0a16f | 应用设置中的：AppKey |
| API密钥 | PRIVATE_KEY | 5eN0HJlo162H27K...6V43TcH | 应用设置中的：Master Secret |
测试短信
- 注意：
- 短信需要配置路由，路径：系统设置 -> 通道管理 -> 通道路由
| 配置名称 | 配置键 | 配置值实例 | 配置说明 |
|---|
通道编号 | 创建通道时填入 | TEST_SMS | 创建通道时使用 |
商户号 | 创建通道时填入 | b4ac08399bdeff1605e0a16f | 无需配置配置，只需要设置路由即可 |
阿里云存储
- 注意：
- 存储需要配置路由，路径：系统设置 -> 通道管理 -> 通道路由
| 配置名称 | 配置键 | 配置值实例 | 配置说明 |
|---|
通道编号 | 创建通道时填入 | ALIYUN_OSS | 创建通道时使用 |
商户号 | 创建通道时填入 | b4ac08399bdeff1605e0a16f | 应用设置中的：AppKey |
| API密钥 | PRIVATE_KEY | | |
| 允许后缀名 | FILE_ALLOW_SUFFIX | .gif,.png,.jpg,.jpeg | 文件后缀 |
| BUCKET_NAME | BUCKET_NAME | lln.public | 阿里云OSS自定义创建的标识符 |
| ENDPOINT | ENDPOINT | oss-cn-shenzhen.aliyuncs.com | 阿里云OSS服务器端点域名 |
腾讯云存储
- 注意：
- 存储需要配置路由，路径：系统设置 -> 通道管理 -> 通道路由
| 配置名称 | 配置键 | 配置值实例 | 配置说明 |
|---|
通道编号 | 创建通道时填入 | TENCENT_OSS | 创建通道时使用 |
商户号 | 创建通道时填入 | b4ac08399bdeff1605e0a16f | 应用设置中的：AppKey |
| API密钥 | PRIVATE_KEY | | |
| 允许后缀名 | FILE_ALLOW_SUFFIX | .gif,.png,.jpg,.jpeg | 文件后缀 |
| BUCKET_NAME | BUCKET_NAME | lln.public | 腾讯OSS自定义文件标识符 |
| 服务器端点域名 | ENDPOINT | lln-public.cos.ap-shanghai.myqcloud.com | 腾讯云OSS服务器端点域名 |
| 服务器地区 | REGION | ap-shanghai | 从ENDPOINT中获取 |
服务器本地存储
为了更好的体验建议使用云OSS存储
- 注意：
- 存储需要配置路由，路径：系统设置 -> 通道管理 -> 通道路由
| 配置名称 | 配置键 | 配置值实例 | 配置说明 |
|---|
通道编号 | 创建通道时填入 | LOCAL_OSS | 创建通道时使用 |
商户号 | 创建通道时填入 | b4ac08399bdeff1605e0a16f | 配置随意 |
| 允许后缀名 | FILE_ALLOW_SUFFIX | .gif,.png,.jpg,.jpeg | 文件后缀 |
快递100
| 配置名称 | 配置键 | 配置值实例 | 配置说明 |
|---|
通道编号 | 创建通道时填入 | KT100 | 创建通道时使用 |
商户号 | 创建通道时填入 | 46A27678CFF1C6A0DAB0BB5155AD3555 | 企业信息中的：customer |
| 授权KEY | key | | 企业信息中的：授权KEY |
| customer | customer | | 企业信息中的：customer |
| API密钥 | secret | | 企业信息中的：secret |
| 物流状态 | state0 | 运输中 | 固定配置值 |
| 物流状态 | state1 | 已揽收 | 固定配置值 |
| 物流状态 | state10 | 待清关 | 固定配置值 |
| 物流状态 | state11 | 清关中 | 固定配置值 |
| 物流状态 | state12 | 已清关 | 固定配置值 |
| 物流状态 | state13 | 清关异常 | 固定配置值 |
| 物流状态 | state14 | 已拒签 | 固定配置值 |
| 物流状态 | state2 | 快递状态异常 | 固定配置值 |
| 物流状态 | state3 | 已签收 | 固定配置值 |
| 物流状态 | state4 | 已退签 | 固定配置值 |
| 物流状态 | state400 | 物流查询配置异常 | 固定配置值 |
| 物流状态 | state5 | 派件中 | 固定配置值 |
| 物流状态 | state500 | 查询不到物流信息 | 固定配置值 |
| 物流状态 | state501 | 物流查询失败 | 固定配置值 |
| 物流状态 | state502 | 物流查询失败 | 固定配置值 |
| 物流状态 | state503 | 物流查询配置错误 | 固定配置值 |
| 物流状态 | state6 | 已退回 | 固定配置值 |
| 物流状态 | state601 | 物流查询配置过期 | 固定配置值 |
| 物流状态 | state7 | 已转投 | 固定配置值 |
其他通道配置配置持续添加中...
注意事项
- 短信 和 文件存储 配置完需要配置路由
- 通道配置全部配置完成后必须在：系统设置 -> 通道管理 -> 通道信息 刷新配置 才能生效
微信服务器验证
https://域名/api/wechat/{商户号}/msg
1