同步微信应用支付资料
查看文档来源信息
- 来源目录：
addons/sys_base/docs - 来源文件：
接口文档/76-同步微信应用支付资料.md
详细说明
用于下游业务模块按正式授权范围低频同步 app_wechat_apps_info 中的微信入口应用资料和支付主体资料。
该接口是服务态受控接口，只允许系统级服务调用。下游同步后在本仓本地执行登录、支付签名、回调验签和解密，不要求每次运行时回到中间件。
该接口不返回运行时 AccessToken，不返回业务回调域名、回调路径和业务子商户归属。
接口信息
| 项目 | 内容 |
|---|---|
| 请求方式 | POST |
| 请求路径 | /sys_base/public/service/syncWechatAppsInfo |
| 来源文件 | 接口文档/76-同步微信应用支付资料.md |
请求头
| 请求头 | 示例值 | 说明 |
|---|---|---|
Content-Type | application/json | 请求体格式。 |
X-System-Key | <system-key> | 请按正式调用约定传入。 |
入参
| 参数 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
addonsType | string | 是 | take_away | 下游业务模块标识，用于限定模块授权范围 |
appUuids | array<string> | 否 | ["0031766249093132337"] | 指定要同步的入口应用 UUID；为空时返回该模块授权的全部应用 |
includeCredentials | boolean | 否 | true | 是否返回密钥、证书文件名、公钥标识等运行所需凭证资料 |
updatedAfter | string | 否 | 2026-05-18T12:00:00+08:00 | 增量同步时间点，支持 RFC3339、yyyy-MM-dd HH:mm:ss、yyyy-MM-dd |
参数说明
请参考上方入参表。
请求示例
当前文档未提供独立请求示例，请参考下方 curl 示例。
响应输出
json
{
"code": 0,
"msg": "成功",
"data": {
"items": [
{
"uuid": "0031766249093132337",
"appUuid": "0031766249093132337",
"addonsType": "take_away",
"appId": "wx1234567890",
"appSecret": "app_secret",
"wechatName": "乐生活小程序",
"type": 1,
"mpUuid": "mp-uuid",
"payMode": "service_provider",
"serviceType": 3,
"mchId": "1234567890",
"mchName": "服务商主体",
"mchCertV3": "apiclient_key.pem",
"mchSecretV3": "api_v3_key",
"wechatPaySerialNo": "wechat_pay_serial_no",
"serialNo": "merchant_serial_no",
"wechatPayPublicKeyId": "PUB_KEY_ID_xxx",
"wechatPayPublicKeyPem": "wechatpay_public_key.pem",
"configVersion": "20260518120000",
"configHash": "c8c1c7...",
"updatedAt": "2026-05-18T12:00:00+08:00",
"remark": "正式应用"
}
]
}
}字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
data.items[].uuid | string | 中间件微信应用记录 UUID |
data.items[].appUuid | string | 正式入口应用 UUID，与 uuid 保持一致，供下游按入口应用定位 |
data.items[].addonsType | string | 本次同步使用的模块标识 |
data.items[].appId | string | 微信 appId |
data.items[].appSecret | string | 微信 appSecret，仅 includeCredentials=true 时返回 |
data.items[].wechatName | string | 微信应用名称 |
data.items[].type | number | 应用类型 |
data.items[].mpUuid | string | 关联公众号 UUID |
data.items[].payMode | string | 固定为 service_provider |
data.items[].serviceType | number | 固定为 3，表示境内服务商 |
data.items[].mchId | string | 服务商商户号 |
data.items[].mchName | string | 商户名称 |
data.items[].mchCertV3 | string | 商户 V3 证书或私钥文件名，不是文件内容 |
data.items[].mchSecretV3 | string | APIv3 Key，仅 includeCredentials=true 时返回 |
data.items[].wechatPaySerialNo | string | 微信支付平台证书序列号 |
data.items[].serialNo | string | 商户证书序列号 |
data.items[].wechatPayPublicKeyId | string | 微信支付公钥 ID |
data.items[].wechatPayPublicKeyPem | string | 微信支付公钥文件名或文件标识，不是文件内容 |
data.items[].configVersion | string | 配置版本，按更新时间生成 |
data.items[].configHash | string | 配置摘要，用于下游判断同步内容是否变化 |
data.items[].updatedAt | string | 中间件记录更新时间 |
data.items[].remark | string | 备注 |
curl 示例
bash
curl --location --request POST 'http://127.0.0.1:8100/sys_base/public/service/syncWechatAppsInfo' \
--header 'Content-Type: application/json' \
--header 'X-System-Key: <system-key>' \
--data-raw '{
"addonsType": "take_away",
"appUuids": ["0031766249093132337"],
"includeCredentials": true
}'