简介
智慧商圈行业解决方案，是微信支付基于商圈场景，通过“拉客进场”、“刺激消费”、“持续经营”，助力商圈全面数字化升级。
商圈，是由不同业态的门店组合而成的综合消费区域，比如购物中心、百货商场、商业街区等等。
可支持： 实体商圈、旅游景区、商业街区
不支持： 商超、自定义的某块区域
商圈接入后，用户可一键开通会员+快速积分服务，在商圈门店消费后可享自动积分及出行服务、门店服务等积分权益。增加用户会员价值感，拉动商圈会员活跃与消费。
- 用户开通授权: 商圈接入后，对于新用户，可实现用户开会员+授权会员积分服务一体化；对于存量会员，可实现快速授权或升级会员积分服务；上述流程均会将商圈的会员卡插入用户卡包。
- 会员快速积分: 已开通的会员用户在商圈内的门店使用微信支付消费后，可以享受会员快速积分服务，提升会员体验，增强会员权益感知。
- 会员出行服务: 商圈停车会员场内消费可100%自动积分，且能便捷使用会员积分进行停车缴费离场；非车主会员也可领取公交地铁等出行优惠券，增加用户会员价值感，拉动商圈会员活跃与消费。
在正式接入微信支付智慧商圈服务前，你需要进行以下准备步骤：
- 选择接入模式：直连商户或服务商
- 申请参数：AppID、商户号
- 智慧商圈接入流程
- 商圈快速积分接入流程
商户需要判断自己公司注册区域适用的接入模式和自身实际情况，申请成为普通商户或普通服务商：
- 普通商户自行申请入驻微信支付，无需服务商协助。
- 普通服务商则自身无法作为一个普通商户直接发起交易，其发起交易必须传入相关特约商户商户号的参数信息。
目前智慧商圈行业解决方案处于公测阶段，仅支持邮件申请开通。
序号申请信息说明1申请对象支持：有统一经营管理者的一块指定区域，如购物中心、百货商场、旅游景区、商业街区等
不支持：无统一经营管理者的自定义区域，或商家联盟2商圈商户号特约商户号/直连商户号，且主体名称/简称与商圈主体一致。3商圈边界提供的商圈边界需要是商圈主体的线下实体商业经营范围，请明确范围边界，否则将会影响商圈门店添加和支付即积分等功能。 正确示范，可按照道路等边界圈定。
登录你的商圈小程序->设置->第三方服务->添加插件插件名称：商圈快速积分
3申请开通“商圈支付即积分”产品能力1、圈选商圈边界
2、填写需要开通“商圈快速积分”插件的小程序信息（已在流程二申请）和回调URL地址
4审批流程商圈边界信息、小程序信息等审核通过后，1-3个工作日内开通成功5启动开发查看积分信息结果通知接口文档
API证书及密钥常见问题：
https://kf.qq.com/product/wechatpaymentmerchant.html(opens new window)
微信支付API证书升级指引
https://kf.qq.com/faq/180824JvUZ3i180824YvMNJj.html(opens new window)
如何设置APIv3密钥？
https://kf.qq.com/faq/180830E36vyQ180830AZFZvu.html(opens new window)
商圈快速积分小程序插件开发文档：
https://mp.weixin.qq.com/wxopen/plugindevdoc?appid=wxfab2bf944bfc4da6&token=1213946737&lang=zh_CN
1. 接口规则
为了在保证支付安全的前提下，带给商户简单、一致且易用的开发体验，我们推出了全新的微信支付APIv3接口。
为了帮助开发者调用开放接口，我们提供了JAVA、PHP、GO三种语言版本的开发库，封装了签名生成、签名验证、敏感信息加/解密、媒体文件上传 等基础功能（更多语言版本的开发库将在近期陆续提供）。
测试步骤：
1、根据自身开发语言，选择对应的开发库并构建项目，具体配置请参考下面链接的详细说明：
- wechatpay-java (opens new window)（推荐）、wechatpay-apache-httpclient (opens new window)，适用于Java开发者。
- 注：当前开发指引接口JAVA示例代码采用wechatpay-apache-httpclient版本。
- wechatpay-php (opens new window)（推荐）、wechatpay-guzzle-middleware (opens new window)，适用于PHP开发者。
- 注：当前开发指引接口PHP示例代码采用wechatpay-guzzle-middleware版本。
- wechatpay-go (opens new window)，适用于Go开发者。
2、创建加载商户私钥、加载平台证书、初始化httpClient的通用方法。
示例代码javaphp
1@Before2public void setup() throws IOException {3 // 加载商户私钥（privateKey：私钥字符串）4 PrivateKey merchantPrivateKey = PemUtil5 .loadPrivateKey(new ByteArrayInputStream(privateKey.getBytes("utf-8")));6 7 // 加载平台证书（mchId：商户号,mchSerialNo：商户证书序列号,apiV3Key：V3密钥）8 AutoUpdateCertificatesVerifier verifier = new AutoUpdateCertificatesVerifier(9 new WechatPay2Credentials(mchId, new PrivateKeySigner(mchSerialNo, merchantPrivateKey)),apiV3Key.getBytes("utf-8"));10 11 // 初始化httpClient12 httpClient = WechatPayHttpClientBuilder.create()13 .withMerchant(mchId, mchSerialNo, merchantPrivateKey)14 .withValidator(new WechatPay2Validator(verifier)).build();15}16 17@After18public void after() throws IOException {19 httpClient.close();20}3、基于接口的示例代码，替换请求参数后可发起测试。
说明：
- 上面的开发库为微信支付官方开发库，其它没有审核或者控制下的第三方工具和库，微信支付不保证它们的安全性和可靠性。通过包管理工具引入SDK后，可根据下面每个接口的示例代码替换相关参数后进行快速测试。
- 开发者如果想详细了解签名生成、签名验证、敏感信息加/解密、媒体文件上传等常用方法的具体代码实现，可阅读下面的详细说明：
- 签名生成
- 签名验证
- 敏感信息加解密
- merchantPrivateKey（私钥）
- wechatpayCertificates（平台证书）
- APIV3Key（V3 key）
- 如想更详细的了解我们的接口规则，可查看我们的接口规则指引文档。
重点步骤说明：
智慧商圈接入前需先邮件申请接入权限
文档展示了如何使用微信支付服务端 SDK 快速接入智慧商圈产品，完成与微信支付对接的部分。
注意
- 文档中的代码示例是用来阐述 API 基本使用方法，代码中的示例参数需替换成商户自己账号及请求参数才能跑通。
- 以下接入步骤仅提供参考，请商户结合自身业务需求进行评估、修改。
微信支付智慧商圈，需先接入商圈快速积分小程序插件。
步骤说明：当用户完成支付，微信会把相关支付结果将通过异步回调的方式通知商户，商户需要接收处理，并按文档规范返回应答。
注意
- 支付结果通知是以POST 方法访问商户设置的通知URL，通知的数据以JSON 格式通过请求主体（BODY）传输。通知的数据包括了加密的支付结果详情。
- 加密不能保证通知请求来自微信。微信会对发送给商户的通知进行签名，并将签名值放在通知的HTTP头Wechatpay-Signature。商户应当验证签名，以确认请求来自微信，而不是其他的第三方。
- 支付通知HTTP应答码为200或204才会当作正常接收，当回调处理异常时，应答的HTTP状态码应为500，或者4xx。
- 商户成功接收到回调通知后应返回成功的HTTP应答码为200或204。
- 同样的通知可能会多次发送给商户系统。商户系统必须能够正确处理重复的通知。 推荐的做法是，当商户系统收到通知进行处理时，先检查对应业务数据的状态，并判断该通知是否已经处理。如果未处理，则再进行处理；如果已处理，则直接返回结果成功。在对业务数据进行状态检查和处理之前，要采用数据锁进行并发控制，以避免函数重入造成的数据混乱。
- 对后台通知交互时，如果微信收到商户的应答不符合规范或超时，微信认为通知失败，微信会通过一定的策略定期重新发起通知，尽可能提高通知的成功率，但微信不保证通知最终能成功。（通知频率为15s/15s/30s/3m/10m/20m/30m/30m/30m/60m/3h/3h/3h/6h/6h - 总计 24h4m）。
步骤说明：商圈服务商针对微信支付前序推送给商圈系统的顾客商圈内交易通知，告知微信支付系统该笔交易的积分情况。
示例代码:
示例代码javaphp
1public void SyncPoints() throws Exception{2 //请求URL3 HttpPost httpPost = new HttpPost("https://api.mch.weixin.qq.com/v3/businesscircle/points/notify");4 // 请求body参数5 String reqdata = "{"6 + "\"transaction_id\":\"4200000533202000000000000000\","7 + "\"appid\":\"wx8828b70xxxxxxx8\","8 + "\"openid\":\"otPAN5xxxxxxxxrOEG6lUv_pzacc\","9 + "\"earn_points\":true,"10 + "\"increased_points\":100,"11 + "\"points_update_time\":\"2020-05-20T13:29:35.120+08:00\","12 + "\"total_points\":888888"13 + "}";14 StringEntity entity = new StringEntity(reqdata,"utf-8");15 entity.setContentType("application/json");16 httpPost.setEntity(entity);17 httpPost.setHeader("Accept", "application/json");1819 //完成签名并执行请求20 CloseableHttpResponse response = httpClient.execute(httpPost);2122 try {23 int statusCode = response.getStatusLine().getStatusCode();24 if (statusCode == 200) { //处理成功25 System.out.println("success,return body = " + EntityUtils.toString(response.getEntity()));26 } else if (statusCode == 204) { //处理成功，无返回Body27 System.out.println("success");28 } else {29 System.out.println("failed,resp code = " + statusCode+ ",return body = " + EntityUtils.toString(response.getEntity()));30 throw new IOException("request failed");31 }32 } finally {33 response.close();34 }35}重要入参说明：
- transaction_id：微信支付推送的商圈内交易通知里携带的微信订单号。
- earn_points：用于标明此单是否获得积分，true为获得积分，false为未获得。
- increased_points：顾客此笔交易新增的积分值。
A：可以。 若一个商圈拥有多个小程序，且在多个小程序场景里都适合引导会员开通【智慧商圈支付即积分】能力，请在提交支付即积分申请时，提交对应的多个小程序的AppID，目前最多支持5个。
A：建议使用微信支付会员卡能力，来提升会员开卡的体验，但是若未使用微信支付会员卡能力，一样可以使用【智慧商圈支付即积分】能力。
【智慧商圈支付即积分】能力的实现非常灵活，使用插件形式，嵌入商圈自有小程序中，由商圈自行进行会员身份判断，若判断是会员则可进入“商圈快速积分插件”，引导用户开通【智慧商圈支付即积分】能力。
A：该问题可通过商圈自行解决，登录商圈小程序后台，更新插件版本。
A：该问题可通过商圈自行解决：
- 确认是服务商模式还是商圈直连模式（登录商户平台确认证书配置）：
- 若是服务商模式，则需要为服务商商户号配置API-V3证书。
- 若是商圈直连模式，则需要为商圈商户号配置API-V3证书。
A：该问题可以通过商圈自检解决。
- 用户插件页检查。
- 用户通过小程序进入插件页面，查看是否有交易但未提交。若有，则证明提前未签到，直接点击提交即可获取积分（注：插件页只能展示当天的场内消费信息，通过交易单号可识别是否为当天交易）;若无，则进行商圈可积分门店检查。
- 若用户插件页无交易-商圈可积分门店检查。
- 该门店未添加进商圈内（可能原门店的商户号变更），自检方式：使用用户交易单号在小程序添加该门店，查看是否可添加，并且该门店已开启“支持积分”（若用户消费前，该门店未被圈入商圈，则该笔交易订单不会自动推送，用户可在商圈圈店后进入插件页手动推送）。
- 用户未在门店消费。
以上内容是智慧商圈简介和使用操作流程，如有不明白之处可以咨询与我们。