为了在保证支付安全的前提下,带给商户简单、一致且易用的开发体验,我们推出了全新的微信支付APIv3接口。该版本API的具体规则请参考“APIv3接口规则”
备注:当前接口用于微信国内钱包
为了帮助开发者调用开放接口,我们提供了JAVA、PHP、GO三种语言版本的开发库,封装了签名生成、签名验证、敏感信息加/解密、媒体文件上传等基础功能(更多语言版本的开发库将在近期陆续提供)
测试步骤:
1、根据自身开发语言,选择对应的开发库并构建项目,具体配置请参考下面链接的详细说明:
• wechatpay-java(推荐)wechatpay-apache-httpclient,适用于Java开发者。
• wechatpay-php(推荐)、wechatpay-guzzle-middleware,适用于PHP开发者
注:当前开发指引接口PHP示例代码采用wechatpay-guzzle-middleware版本
• wechatpay-go,适用于Go开发者
更多资源可前往微信支付开发者社区搜索查看
2、创建加载商户私钥、加载平台证书、初始化httpClient的通用方法
@Before
public void setup() throws IOException {
// 加载商户私钥(privateKey:私钥字符串)
PrivateKey merchantPrivateKey = PemUtil
.loadPrivateKey(new ByteArrayInputStream(privateKey.getBytes("utf-8")));
// 加载平台证书(mchId:商户号,mchSerialNo:商户证书序列号,apiV3Key:V3密钥)
AutoUpdateCertificatesVerifier verifier = new AutoUpdateCertificatesVerifier(
new WechatPay2Credentials(mchId, new PrivateKeySigner(mchSerialNo, merchantPrivateKey)),apiV3Key.getBytes("utf-8"));
// 初始化httpClient
httpClient = WechatPayHttpClientBuilder.create()
.withMerchant(mchId, mchSerialNo, merchantPrivateKey)
.withValidator(new WechatPay2Validator(verifier)).build();
}
@After
public void after() throws IOException {
httpClient.close();
}
3、基于接口的示例代码,替换请求参数后可发起测试
说明:
• 上面的开发库为微信支付官方开发库,其它没有审核或者控制下的第三方工具和库,微信支付不保证它们的安全性和可靠性
通过包管理工具引入SDK后,可根据下面每个接口的示例代码替换相关参数后进行快速测试
• 开发者如果想详细了解签名生成、签名验证、敏感信息加/解密、媒体文件上传等常用方法的具体代码实现,可阅读下面的详细说明:
1.签名生成
2.签名验证
3.敏感信息加解密
• 如想更详细的了解我们的接口规则,可查看我们的接口规则指引文档
步骤1 商户登录微信支付商户平台,可通过《创建消费卡》页面创建消费卡,并配置好关联的消费券,更多指引请查看配置应用
步骤5 商户调用《发放消费卡》接口向用户发放消费卡,并接收接口返回的发放结果
步骤6 系统自动向用户发送领取消费卡消息,并存入用户卡包。用户点击消息可查看消费卡以及消费券
文档展示了如何使用微信支付服务端 SDK 快速接入消费卡产品,完成与微信支付对接的部分。
注意:
步骤说明:该接口主要为商户提供营销资源的授权能力,可授权给其他商户或小程序,方便商户间的互利合作。
示例代码:
public void SendCoupons() throws Exception{
// 加载商户私钥(privateKey:私钥字符串)
PrivateKey merchantPrivateKey = PemUtil
.loadPrivateKey(new ByteArrayInputStream(privateKey.getBytes("utf-8")));
// 加载平台证书(mchId:商户号,mchSerialNo:商户证书序列号,apiV3Key:V3秘钥)
AutoUpdateCertificatesVerifier verifier = new AutoUpdateCertificatesVerifier(
new WechatPay2Credentials(mchId, new PrivateKeySigner(mchSerialNo, merchantPrivateKey)),apiV3Key.getBytes("utf-8"));
CloseableHttpClient httpClient = HttpClients.createDefault();
// 初始化httpClient
httpClient = WechatPayHttpClientBuilder.create()
.withMerchant(mchId, mchSerialNo, merchantPrivateKey)
.withValidator(new WechatPay2Validator(verifier)).build();
//请求URL
HttpPost httpPost = new HttpPost("https://api.mch.weixin.qq.com/v3/marketing/busifavor/coupons/pIJMr5MMiIkO_93VtPyIiEk2DZ4w/send");
// 请求body参数
String reqdata = "{"
+ "\"send_time\":\"2019-12-31T13:29:35.120+08:00\","
+ "\"openid\":\"obLatjhnqgy2syxrXVM3MJirbkdI\","
+ "\"appid\":\"wxc0b84a53ed8e8d29\","
+ "\"out_request_no\":\"oTYhjfdsahnssddj_0136\""
+ "}";
StringEntity entity = new StringEntity(reqdata,"utf-8");
entity.setContentType("application/json");
httpPost.setEntity(entity);
httpPost.setHeader("Accept", "application/json");
//完成签名并执行请求
CloseableHttpResponse response = httpClient.execute(httpPost);
try {
int statusCode = response.getStatusLine().getStatusCode();
if (statusCode == 200) { //处理成功
System.out.println("success,return body = " + EntityUtils.toString(response.getEntity()));
} else if (statusCode == 204) { //处理成功,无返回Body
System.out.println("success");
} else {
System.out.println("failed,resp code = " + statusCode+ ",return body = " + EntityUtils.toString(response.getEntity()));
throw new IOException("request failed");
}
} finally {
response.close();
}
}
重要入参说明:
• appid:消费卡card_id 归属appid,需与api调用方商户号有M-A绑定关系,需和创建消费卡信息中填入的归属appid一致
更多参数、响应详情及错误码请参见发放消费卡接口文档
A:签名错误请参考文档签名相关问题
A:消费卡card_id归属appid,需和创建消费卡信息中填入的归属appid一致,且该appid需和api调用方商户号有M-A绑定关系
A:每微信用户限领1张,用户本人或同一用户的其他微信号(绑定了同一个实名用户银行卡的微信)已领取过消费卡
A:请按照以下流程申请
1、与对应的微信支付BD联系,签署公众号-商户号和小程序-商户号联合运营函,并归档
2、按照如下邮件模板发送申请邮件至对应的微信支付BD
邮件名称:xxx礼品卡非同主体支付绑定申请
邮件内容:
公众号名称
认证公众号appid
公众号主体信息
认证小程序appid
小程序主体信息
礼品卡专用商户号
商户号对应的公司名称
3、确认信息无误后,微信支付将在五个工作日内处理
注意:若没有直接对接的微信侧业务人员,则不能申请,给您带来不便,十分抱歉