微信支付合作伙伴平台

接口说明

适用对象： 服务商

请求URL：该链接是通过【设置商家券事件通知地址API】提交notify_url参数设置，必须为https协议。如果链接无法访问，商户将无法接收到微信通知。 通知url必须为直接可访问的url，不能携带参数。示例：“https://pay.weixin.qq.com/wxpay/pay.action”

通知规则

领券完成后，微信会把相关领券结果和用户信息发送给商户，商户需要接收处理，并按照文档规范返回应答。出于安全的考虑，我们对支付结果数据进行了加密，商户需要先对通知数据进行解密，才能得到支付结果数据。

对后台通知交互时，如果微信收到应答不是成功或超时，微信认为通知失败，微信会通过一定的策略定期重新发起通知，尽可能提高通知的成功率，但微信不保证通知最终能成功。（通知频率为60s/次 - 总计11次 ）

通知报文

领券结果通知是以POST 方法访问商户设置的通知url，通知的数据以JSON 格式通过请求主体（BODY）传输。通知的数据包括了加密的支付结果详情。

参数解密

下面详细描述对通知数据进行解密的流程：

1. 1、用商户平台上设置的APIv3密钥【微信商户平台—>账户设置—>API安全—>设置APIv3密钥】，记为key。
2. 2、针对resource.algorithm中描述的算法（目前为AEAD_AES_256_GCM），取得对应的参数nonce和associated_data。
3. 3、使用key、nonce和associated_data，对数据密文resource.ciphertext进行解密，得到JSON形式的资源对象。

通知参数

通知签名

加密不能保证通知请求来自微信。微信会对发送给商户的通知进行签名，并将签名值放在通知的HTTP头Wechatpay-Signature。商户应当验证签名，以确认请求来自微信，而不是其他的第三方。签名验证的算法请参考 《微信支付API v3签名验证》。

回调示例

领券成功通知结果

{ 
    "id":"8b33f79f-8869-5ae5-b41b-3c0b59f957d0",
    "create_time":"2019-12-12T16:54:38+08:00",
    "resource_type":"encrypt-resource",
    "event_type":"COUPON.SEND",
    "summary":"商家券领券通知",
    "resource":{
        "original_type":"coupon",
        "algorithm":"AEAD_AES_256_GCM",
        "ciphertext":"xxx",
        "associated_data":"coupon",
        "nonce":"j9g1wAzF9Xn1"
     } 
} 

商户对resource对象进行解密后，得到的资源对象示例

{   
	"event_type":"EVENT_TYPE_BUSICOUPON_SEND",
	"coupon_code":"1227944959000000911017",
	"stock_id":"1286950000000039",
	"send_time":"2019-12-17T10:35:53+08:00",
	"openid":"odXnH1CJjeQoWTld48db-pnxs-Wg",
	"unionid":"oOuyajgxj0oVwjocSoQm6mp7PGKw",
	"send_channel":"BUSICOUPON_SEND_CHANNEL_PAYGIFT", 
	"send_merchant":"98568888",
	"attach_info":{
		"transaction_id":"4200000462220200226114599",
		"act_code":"540358695"
		}
}

领券成功通知参数

通知应答

接收成功：HTTP应答状态码需返回200或204，无需返回应答报文。

接收失败：HTTP应答状态码需返回5XX或4XX，同时需返回应答报文，格式如下：

{   
    "code": "FAIL",
    "message": "失败"
}