微信支付对账单下载
微信支付对账单下载
应用场景
商户可以通过该接口下载历史交易清单。比如掉单、系统错误等导致商户侧和微信侧数据不一致,通过对账单核对后可校正支付状态。
注意事项
1. 微信侧未成功下单的交易不会出现在对账单中。
2. 支付成功但退款成功的交易也不会出现在对账单中。
3. 对账单下载时间范围为最近30天,超过30天的历史数据需要通过其他接口获取。
步骤
1. 获取API密钥:首先需要在微信支付平台上申请一个API密钥,这个密钥用于认证和签名。
2. 构造请求参数:使用POST方法,向微信支付服务器发送请求,包含以下参数:
* `appid`:应用ID* `mch_id`:商户号* `nonce_str`:随机字符串* `sign`:签名3. 下载对账单:接收到响应后,会返回一个XML文件,包含历史交易清单。
参数说明
以下是请求参数和响应参数的详细说明:
请求参数
| 参数名称 | 类型 | 必填 |说明 |
| --- | --- | --- | --- |
| appid | String | 是 | 应用ID |
| mch_id | String | 是 | 商户号 |
| nonce_str | String | 是 | 随机字符串 |
| sign | String | 是 | 签名 |
响应参数
| 参数名称 | 类型 |说明 |
| --- | --- | --- |
| return_code | String | 返回状态码 |
| return_msg | String | 返回信息 |
| bill_date | String | 对账单日期 |
| bill_type | String | 对账单类型 |
| total_count | Integer | 总条数 |
| invoice_item_list | Array | 发票明细列表 |
示例代码
以下是使用Python语言的示例代码:
```pythonimport requests API密钥appid = 'your_appid'
mch_id = 'your_mch_id'
随机字符串nonce_str = 'your_nonce_str'
签名sign = 'your_sign'
构造请求参数params = {
'appid': appid,
'mch_id': mch_id,
'nonce_str': nonce_str,
'sign': sign}
下载对账单response = requests.post(' params=params)
响应内容content = response.content保存对账单文件with open('对账单.xml', 'wb') as f:
f.write(content)
```
注意事项
以上示例代码仅供参考,请根据实际情况进行修改和完善。