接入微信支付
1. 接口规则
为了在保证支付安全的前提下,带给商户简单、一致且易用的开发体验,我们推出了全新的微信支付APIv3接口。该版本API的具体规则请参考APIv3接口规则。
2. 开发准备 2.1. 搭建和配置开发环境
为了帮助开发者调用开放接口,我们提供了JAVA、PHP、GO三种语言版本的开发库,封装了签名生成、签名验证、敏感信息加/解密、媒体文件上传 等基础功能(更多语言版本的开发库将在近期陆续提供)。
测试步骤:
1、根据自身开发语言,选择对应的开发库并构建项目,具体配置请参考下面链接的详细说明:
-php (opens new window)(推荐)、-guzzle- (opens new window),适用于PHP开发者。 -go (opens new window)1688批发网,适用于Go开发者。
更多资源可前往微信支付开发者社区 (opens new window)搜索查看。
2、创建加载商户私钥、加载平台证书、初始化的通用方法。
示例代码
3、基于接口的示例代码,替换请求参数后可发起测试。
说明:
签名生成 签名验证 敏感信息加解密 (私钥) s(平台证书) (V3 key) 3. 快速接入 3.1. 业务流程图
重点步骤说明:
智慧商圈接入前需先邮件申请接入权限,申请发放具体可查看接入前准备接入微信支付,小程序插件可参考:小程序插件开发文档 (opens new window)。
步骤10 商圈会员场内支付结果通知(已开通积分功能的用户,在场内发生交易时,会将交易信息返回至开通时提交的回调地址)。
步骤12 商圈积分通知回调(只有接入该接口,才会获取到退款信息)。
步骤13 商圈会员场内退款结果通知(对已同步过积分的交易,监控30天内的退款情况,若发生退款,则会把相关退款通知发送给商圈商户,商户的回调地址同支付结果回调地址保持一致)。
3.2. API接入(含示例代码)
文档展示了如何使用微信支付服务端 SDK 快速接入智慧商圈产品,完成与微信支付对接的部分。
注意
3.2.1. 【客户端】商圈快速积分小程序插件
微信支付智慧商圈,需先接入商圈快速积分小程序插件。小程序插件可参考:小程序插件开发文档 (opens new window)。
3.2.2. 【服务端】接收商圈支付结果通知
步骤说明:当用户完成支付,微信会把相关支付结果将通过异步回调的方式通知商户,商户需要接收处理,并按文档规范返回应答。
注意
接入顺序:
“商圈会员快速积分”小程序插件开发文档 (opens new window)。 商圈会员积分服务授权结果通知(用户在商圈小程序完成会员积分服务授权后,会将用户的授权情况发送至开通时配置的会员积分服务开通回调地址)。 商圈会员场内支付结果通知(已授权商圈会员积分服务的用户,在场内发生微信支付交易时,会将消费信息发送至开通时配置的用户消费回调地址)。 商圈积分通知回调(只有接入该接口,才会获取到退款信息)。 商圈会员场内退款通知(对已同步过积分的会员消费,监控30天内的退款情况,若发生退款,会将退款信息发送至开通时配置的用户消费回调地址)。 商圈积分授权查询 (可通过此API查询已授权过商圈会员积分服务用户的最新授权状态)。 查询商圈会员待积分状态(可通过此API查询已授权商圈会员积分服务的用户当天是否有待积分的消费,并可在商圈小程序任意页面引导用户前往“商圈会员快速积分”插件提交积分申请)。 更新商圈会员停车状态(可通过此API同步会员停车到场状态给微信支付,对用会员的商场内门店消费可100%自动积分)。
更多参数、响应详情及错误码请参见 商圈支付结果通知API接口文档。
3.2.3. 【服务端】商圈积分同步
步骤说明:商圈服务商针对微信支付前序推送给商圈系统的顾客商圈内交易通知,告知微信支付系统该笔交易的积分情况。
示例代码
重要入参说明:
更多参数、响应详情及错误码请参见商圈积分同步接口文档。
4. 常见问题 Q:一个商圈拥有多个小程序,是否可以在多个小程序中都嵌入“商圈快速积分插件”?
A:可以。 若一个商圈拥有多个小程序,且在多个小程序场景里都适合引导会员开通【智慧商圈支付即积分】能力,请在提交支付即积分申请时,提交对应的多个小程序的AppID,目前最多支持5个。
Q:是否必须使用微信支付会员卡能力,才能使用【智慧商圈支付即积分】能力?
A:建议使用微信支付会员卡能力,来提升会员开卡的体验,但是若未使用微信支付会员卡能力,一样可以使用【智慧商圈支付即积分】能力。
【智慧商圈支付即积分】能力的实现非常灵活,使用插件形式,嵌入商圈自有小程序中,由商圈自行进行会员身份判断,若判断是会员则可进入“商圈快速积分插件”微信会员卡平台,引导用户开通【智慧商圈支付即积分】能力。
Q:提交积分申请时提示“网络错误,请稍后重试”
A:该问题可通过商圈自行解决,登录商圈小程序后台微信会员卡平台,更新插件版本。
Q:提交积分申请时提示“”
A:该问题可通过商圈自行解决:
按照接口文档进行API证书配置,积分信息回调接口文档, API证书配置。 Q:用户未自动获取到积分(商圈未收到回调信息)
A:该问题可以通过商圈自检解决:
若用户插件页无交易-商圈可积分门店检查。
【本文来源于互联网转载,如侵犯您的权益或不适传播,请邮件通知我们删除】