PHP可自动拉取微信/支付宝账单并完成订单对账：调用API下载CSV、解析映射为标准结构、比对数据库订单、同步状态、定时执行并日志归档。
如果您的PHP网站需要与第三方支付平台对接并完成每日账单核对，则可能面临手动下载账单、逐条比对订单状态等低效操作。以下是实现PHP自动拉取第三方支付账单并完成系统订单自动对账的具体方法：
一、调用第三方支付平台账单下载API
多数主流支付平台（如微信支付、支付宝）均提供按日期生成和下载账单的HTTPS接口，PHP可通过cURL发起请求获取原始账单数据，通常为CSV格式。该方式避免人工介入，确保账单来源权威且时效性强。
1、在微信支付商户平台开通账单下载权限，并获取API证书及商户密钥。
2、构造符合微信支付规范的签名参数，包括appid、mch_id、device_info、nonce_str、sign_type、bill_date、bill_type，其中bill_date需格式化为YYYYMMDD。
立即学习“PHP免费学习笔记（深入）”；
3、使用PHP cURL发送POST请求至https://api.mch.weixin.qq.com/v3/bill/download-url，Header中携带Authorization Bearer令牌。
4、解析返回的JSON响应，提取download_url字段值，再次用GET请求访问该URL，传入商户证书进行双向SSL认证，接收CSV流内容。
5、将接收到的CSV内容写入临时文件，并校验首行是否包含“交易时间,公众账号ID,商户号,子商户号,设备号,微信订单号,商户订单号”等关键字段。
二、解析CSV账单并映射为标准数据结构
第三方账单格式不统一，需将其规范化为内部可处理的数组结构，重点提取交易状态、金额、订单号、时间戳等核心字段，为后续比对提供一致输入。
1、使用fgetcsv()逐行读取CSV文件，跳过表头行及空行。
2、对每一行执行trim()和mb_convert_encoding()转换，确保中文字段不乱码，兼容UTF-8-BOM。
3、根据支付平台类型判断字段顺序：微信账单第5列为微信订单号，第6列为商户订单号；支付宝账单第1列为支付宝流水号，第2列为商户订单号。
4、构建标准化账单记录数组，包含键名：pay_order_no、out_trade_no、amount、status、pay_time、fee_type，其中amount统一转为分单位整型，status映射为success / closed / refund。
5、将全部记录存入内存数组$billRecords，并按out_trade_no建立哈希索引，便于O(1)查找。
三、查询本地数据库匹配订单记录
通过商户订单号（out_trade_no）关联本地订单表，筛选出当日或指定周期内已创建但未完成对账的订单，形成待校验集合，避免全表扫描提升效率。
1、连接MySQL数据库，执行预处理语句SELECT id, order_no, total_fee, status, pay_time FROM orders WHERE order_no IN ( ? ) AND status IN ('unpaid', 'paid', 'refunded') AND created_at >= DATE_SUB(NOW(), INTERVAL 7 DAY)。
2、将$billRecords中的全部out_trade_no提取为去重数组，批量绑定至IN子句，防止SQL注入。
3、遍历查询结果集，以order_no为键建立本地订单索引数组$localOrders。
4、对每个$localOrders[$orderNo]，检查其total_fee是否等于$billRecords[$orderNo]['amount']，若不等则标记为金额异常。
5、若$billRecords中存在$localOrders中无对应记录的out_trade_no，说明为漏单；反之，$localOrders中存在但$billRecords中缺失，则为漏账。
四、执行差异识别与状态同步
依据账单与本地订单的匹配结果，分类执行状态更新、异常记录入库、通知触发等动作，确保系统订单状态与支付平台最终态一致。
1、对匹配成功且金额/状态一致的订单，执行UPDATE orders SET pay_status = 'matched', matched_at = NOW() WHERE order_no = ?。
2、对匹配成功但支付状态为closed或refund的订单，执行UPDATE orders SET status = 'closed', refund_amount = ? WHERE order_no = ?。
3、对金额不一致的订单，插入records_mismatch表，字段包括order_no、bill_amount、local_amount、mismatch_type、created_at。
4、对账单中有而本地无的订单（漏单），插入records_orphan表，记录pay_order_no、out_trade_no、amount、source_platform、created_at。
5、对本地有而账单中无的订单（漏账），执行UPDATE orders SET pay_status = 'pending_bill' WHERE order_no IN (?) AND pay_status != 'matched'。
五、定时任务集成与日志归档
将上述流程封装为独立PHP脚本，通过系统级定时任务驱动执行，同时记录完整操作日志，支撑问题回溯与审计要求。
1、编写cli入口脚本check_payment_reconciliation.php，接收--date=20240520参数，默认为昨日日期。
2、在Linux系统中添加crontab -e，配置0 2 * * * /usr/bin/php /var/www/html/cli/check_payment_reconciliation.php --date=$(date -d "yesterday" +\%Y\%m\%d)。
3、使用error_log()将每步操作写入/var/log/php-recon/20240520.log，包含开始时间、处理账单行数、匹配成功数、异常数量。
4、账单CSV原始文件移动至/archived_bills/wechat/20240520.csv，设置chmod 400防止误修改。
5、脚本末尾调用gc_collect_cycles()释放内存，并输出本次对账完成，共处理327笔交易，发现2笔金额异常，0笔漏单。
