商圈会员场内支付结果通知
更新时间:2024.11.18已授权“商圈会员积分服务”的用户在商圈内门店使用微信支付消费后,微信会把相关消费情况通知给商圈商户。
|
接口说明
支持商户:【普通商户】
请求方式:【POST】
回调URL: 由商圈侧提供接口链接地址,必须为HTTPS协议。如果链接无法访问,商户将无法接收到微信通知。 通知URL必须为直接可访问的URL,不能携带参数。示例:"https://pay.wechatpay.cn/wxpay/pay.action"
通知规则
已授权会员用户在商圈内的门店使用微信支付消费后,微信会把相关消费情况通知给商圈商户,商户需要接收处理,并返回应答。出于安全的考虑,我们对消费数据进行了加密,商户需要先对通知数据进行解密,才能得到可用数据。
对后台通知交互时,如果微信收到商户的应答不是成功或超时,微信认为通知失败,微信会通过一定的策略重新发起通知,尽可能提高通知的成功率,但微信不保证通知最终能成功。(通知频率为15s/15s/30s/3m/10m/20m/30m/30m/30m/60m/3h/3h/3h/6h/6h - 总计 24h4m)
通知报文
支付结果通知是以POST方法访问商户设置的通知URL,通知的数据以JSON格式通过请求主体(BODY)传输。通知的数据包括了加密的支付结果详情。
|
步骤说明
步骤一:验证签名
微信支付会对发送给商户的通知进行签名,并将签名值放在通知的HTTP头Wechatpay-Signature。商户应当验证签名,以确认请求来自微信,而不是其他的第三方。签名验证的算法请参考 《微信支付API v3签名验证》。
步骤二:参数解密
为了保证安全性,微信支付在回调通知,对关键信息进行了AES-256-GCM加密。商户应当按照以下的流程进行解密关键信息,解密的流程:
用商户平台上设置的APIv3密钥【微信服务商平台—>账户设置—>API安全—>设置APIv3密钥】,记为key;
获取resource.algorithm中描述的算法(目前为AEAD_AES_256_GCM),以及resource.nonce和resource.associated_data;
使用key、nonce和associated_data,对数据密文resource.ciphertext进行解密,得到JSON形式的资源对象。
|
通知参数
BODY 包体参数
id
必填 string(36)
通知的唯一ID。
create_time
必填 string(16)
遵循rfc3339标准格式,格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE,yyyy-MM-DD表示年月日,T出现在字符串中,表示time元素的开头,HH:mm:ss.表示时分秒,TIMEZONE表示时区(+08:00表示东八区时间,领先UTC 8小时,即北京时间)。例如:2015-05-20T13:29:35+08:00表示北京时间2015年05月20日13点29分35秒。
event_type
必填 string(32)
通知的类型, 会员积分服务授权通知的类型为:MALL_AUTH.ACTIVATE_CARD
resource_type
必填 string(32)
通知的资源数据类型。支付成功通知为encrypt-resource。
resource
必填 object
通知资源数据
json格式,见示例
属性 | |
summary
必填 string(64)
回调摘要
支付结果通知
resource解密后字段
BODY 包体参数
mchid
必填 string(32)
微信支付分配的商户号
merchant_name
必填 string(128)
商圈商户名称
shop_name
必填 string(32)
门店名称,商圈在商圈小程序上圈店时填写的门店名称
shop_number
必填 string(128)
门店编号,商圈在商圈小程序上圈店时填写的门店编号,用于跟商圈自身已有的商户识别码对齐
appid
必填 string(32)
顾客授权积分时使用的小程序的AppID
openid
必填 string(128)
顾客授权时使用的小程序上的OpenID
time_end
必填 string(16)
交易完成时间,遵循rfc3339标准格式,格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE,yyyy-MM-DD表示年月日,T出现在字符串中,表示time元素的开头,HH:mm:ss表示时分秒毫秒,TIMEZONE表示时区(+08:00表示东八区时间,领先UTC 8小时,即北京时间)。例如:2015-05-20T13:29:35+08:00表示北京时间2015年05月20日13点29分35秒(需要增加所有跟时间有关的参数的描述)
amount
必填 int
用户实际消费金额,单位(分)
transaction_id
必填 string(32)
微信支付订单号
commit_tag
选填 string(32)
手动提交积分标记,自动提交时无该字段,用于区分用户手动申请后推送的积分数据
对resource对象进行解密后,得到的资源对象示例
通知应答
接收成功: HTTP应答状态码需返回200或204,无需返回应答报文。
接收失败: HTTP应答状态码需返回5XX或4XX,同时需返回应答报文,格式如下:
BODY 包体参数
code
必填 string(32)
【返回状态码】 错误码,SUCCESS为清算机构接收成功,其他错误码为失败。
message
必填 string(256)
【返回信息】 返回信息,如非空,为错误原因。
应答示例