微信支付商户平台

接口说明

适用对象：直连商户

请求URL：该链接是通过【创建投诉通知回调接口】中提交的参数url设置，如果链接无法访问，商户将无法接收到微信通知。

通知规则

新投诉产生、投诉状态发生变化时，微信后台会把投诉信息发送给商户，商户需要接收处理该消息，并返回应答。

对后台通知交互时，如果微信收到应答不是成功或超时，微信认为通知失败，微信会通过一定的策略定期重新发起通知，尽可能提高通知的成功率，但微信不保证通知最终能成功。（通知频率为5s * 1次，1min * 10次，之后以5min间隔重试，重试1000次或最多持续1周）

通知报文

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

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

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

注： AEAD_AES_256_GCM算法的接口细节，请参考rfc5116。微信支付使用的密钥key长度为32个字节，随机串nonce长度12个字节，associated_data长度小于16个字节并可能为空。

通知参数

通知签名

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

回调示例

新生成投诉通知

{
    "id":"EV-2018022511223320873",
    "create_time":"2015-05-20T13:29:35.120+08:00",
    "resource_type":"encrypt-resource",
    "event_type":"COMPLAINT.CREATE",
    "resource" : {
        "algorithm":"AEAD_AES_256_GCM",
        "ciphertext": "...",
        "nonce": "...",
        "associated_data": ""
    }
}

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

{
  "complaint_id": "200201820200101080076610000",
	"action_type":"CREATE_COMPLAINT"
}

通知参数

通知应答

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

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

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