最新更新时间:2022.08.25 版本说明
通过此API,商圈商户/服务商可将会员的停车状态同步给微信支付,以辅助判断用户到场,用户在商圈内门店消费可自动积商圈会员积分。
商户上送敏感信息时使用微信支付平台公钥加密,证书序列号包含在请求HTTP头部的Wechatpay-Serial,详见接口规则
接入顺序
2. 商圈会员积分服务授权结果通知(用户在商圈小程序完成会员积分服务授权后,会将用户的授权情况发送至开通时配置的会员积分服务开通回调地址)
3. 商圈会员场内支付结果通知(已授权商圈会员积分服务的用户,在场内发生微信支付交易时,会将消费信息发送至开通时配置的的用户消费回调地址)
4. 商圈会员积分同步(只有接入该接口,才会获取到退款信息)
5. 商圈会员场内退款通知(对已同步过积分的会员消费,监控30天内的退款情况,若发生退款,会将退款信息发送至开通时配置的的用户消费回调地址)
6. 商圈会员积分服务授权状态查询 (可通过此api查询已授权过商圈会员积分服务用户的最新授权状态)
7. 商圈会员待积分状态查询(可通过此api查询已授权商圈会员积分服务的用户当天是否有待积分的消费,并可在商圈小程序任意页面引导用户前往“商圈会员快速积分”插件提交积分申请)
8. 商圈会员停车状态同步(可通过此api同步会员停车到场状态给微信支付,对用会员的商场内门店消费可100%自动积分)
适用对象:服务商
请求URL:https://api.mch.weixin.qq.com/v3/businesscircle/parkings
请求方式:post
path指该参数为路径参数
query指该参数需在请求URL传参
body指该参数需在请求JSON传参
参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
---|---|---|---|---|
子商户号 | sub_mchid | string[1,32] | 否 | body微信支付分配的子商户号,服务商模式下必传 示例值:1900000109 |
品牌ID | brandid | int | 是 | body调用方商户号对应的品牌brandid,调用方商户号需为此品牌brandid的品牌主商户号或品牌服务商商户号 示例值:1000 |
应用ID | appid | string[1,32] | 是 | body支持服务号、小程序等类型的AppID,需已与brandid完成下单AppID绑定 示例值:wx931386123456789e |
用户标识 | openid | string[1,64] | 是 | body用户在商户对应AppID下的唯一标识 示例值:oUpF8uMuAJOM2pxb1Q |
车牌号 | plate_number | string[1,32] | 是 | body首位需为省份的中文简称,第二位起支持大写字母、数字、中文 示例值:粤B888888 |
状态 | state | string | 是 | body停车状态,服务商模式下必传 IN:入场,用户开车进入商圈 OUT:离场,用户开车离开商圈 示例值:IN |
时间 | time | string[1,32] | 是 | body在场状态更新时间,按照使用rfc3339所定义的格式,格式为yyyy-MM-DDThh:mm:ss+TIMEZONE 示例值:2022-06-01T10:43:39+08:00 |
{
"appid": "wx931386123456789e",
"brandid": 1000,
"openid": "oUpF8uMuAJOM2pxb1Q",
"plate_number": "粤B888888",
"state": "IN",
"sub_mchid": "1900000109",
"time": "2022-06-01T10:43:39+08:00"
}
状态码 | 错误码 | 描述 | 解决方案 |
---|---|---|---|
400 | PARAM_ERROR | 业务必填字段brand_id为空 | 参数有误,品牌ID brandid 为空 |
PARAM_ERROR | 业务必填字段appid为空 | 参数有误,应用ID appid 为空 | |
PARAM_ERROR | 业务必填字段openid为空 | 参数有误,用户标识 openid 为空 | |
PARAM_ERROR | 业务必填字段plate_number为空 | 参数有误,车牌号 plate_number 为空 | |
PARAM_ERROR | 业务必填字段state为空 | 参数有误,状态 state 为空 | |
PARAM_ERROR | 业务必填字段time为空 | 参数有误,时间 time 为空 | |
PARAM_ERROR | plate_number格式有误 | 参数有误,车牌号 plate_number 格式有误 | |
PARAM_ERROR | time格式有误 | 时间 time 格式有误,请修改后重试 | |
PARAM_ERROR | time超出取值范围 | 时间 time 不能为未来的时间点,请修改后重试 | |
PARAM_ERROR | openid有误 | 用户openid 有误,请修改后重试 | |
PARAM_ERROR | appid有误 | appid 有误,请修改后重试 | |
PARAM_ERROR | sub_mch_code有误 | 子商户号 sub_mchid 有误,请修改后重试 | |
403 | NOAUTH | mch_id与brand_id关系不匹配 | 非brandid品牌主商户号或品牌服务商商户号,请修改后重试 |
NOAUTH | openid与appid不匹配 | openid与appid不匹配,非传入appid下的用户openid,请修改后重试 | |
NOAUTH | 父子关系不匹配 | mchid与sub_mchid无父子关系,请修改后重试 | |
NOAUTH | sub_mch_code与brand_id不匹配 | 传入的sub_mchid非brandid的品牌主商户号,请修改后重试 | |
NOAUTH | brandid与appid不匹配 | appid未与brandid绑定,请修改后重试 | |
NOAUTH | brandid无对应的唯一商圈mainid | brandid下商圈不唯一,请修改后重试 | |
500 | SYSTEMERROR | 系统必填字段source为空 | 系统错误,请稍后再试 |
SYSTEMERROR | 系统必填字段machine_key为空 | 系统错误,请稍后再试 | |
SYSTEMERROR | 系统必填字段mch_id为空 | 系统错误,请稍后再试 | |
SYSTEMERROR | 保存数据失败 | 系统错误,请稍后再试 | |
SYSTEMERROR | brandid无对应的唯一商圈mainid | brandid下商圈不唯一,请修改后重试 |