Westpac PayWay API 澳大利亚支付网关介绍
Westpac PayWay API Payment Gateway 面向使用澳大利亚 Westpac PayWay 收款服务的 WooCommerce 商家。它通过 PayWay API 把信用卡支付流程集成到商城结账中，支持经典结账和区块结账，并可在 WooCommerce 订单后台执行全额或部分退款。对于销售周期服务、会员或预售商品的商家，扩展还支持 WooCommerce Subscriptions 的自动续费和付款方式变更。
PayWay API 与托管支付页面并非同一种方式
API 集成让顾客在商城的结账流程中输入卡片信息，商家获得更连贯的品牌体验，但服务器和支付数据安全要求也更高。官方说明要求使用 API 集成时，网站服务器应符合 PCI DSS 支付卡行业数据安全标准。若商家希望顾客在 Westpac 托管的页面输入卡片信息，则应比较 Westpac 提供的其他托管式集成，而不是把不同集成方式的配置说明混用。
官方产品页说明 Visa 和 Mastercard 默认可用，American Express 和 Diners Club 可能需要 Westpac 额外开通。具体可接受的卡组织、交易类型和结算方式应以商户合同及 PayWay 后台配置为准。
适合的业务场景
- 在线零售：顾客在 WooCommerce 结账时使用信用卡完成付款。
- 周期订阅：会员、服务计划和定期商品可按订阅规则发起续费扣款。
- 预售商品：在下单时记录支付方式，待商品正式发布或满足条件后再扣款。
- 订单财务处理：管理员可在订单页面查看支付状态，并按权限处理捕获、退款或撤销。
账户和服务器准备
安装前应取得 Westpac PayWay 商户账户及 API 接入资料，确认测试环境和正式环境凭据分开。服务器必须启用 HTTPS，并由技术人员检查 PCI 相关安全配置、访问控制、日志和数据保留策略。支付页面不要经过会修改表单字段或拦截脚本的缓存优化规则；如果使用安全插件或 WAF，也要验证支付回调不会被误拦截。
从测试环境开始配置
- 在测试站安装并启用插件，先确认经典结账或 Checkout Block 与当前主题和结账扩展兼容。
- 进入 WooCommerce 支付设置，启用 Westpac PayWay API，并填写服务商提供的测试环境凭据。
- 配置结账页显示名称、支付说明和允许的卡组织，确认商户账户已开通对应卡种。
- 开启测试模式，模拟成功付款、拒绝交易、取消付款和重复提交，检查订单状态与日志。
- 若使用订阅，测试首次付款、自动续费、修改支付方式和续费失败后的处理。
- 若业务使用预授权，确认何时捕获资金，并测试部分退款与撤销授权流程。
退款和订阅不能只测首次付款
支付插件上线后，真正容易出现问题的往往是退款、续费和客户更换卡片。商家应确认 WooCommerce 后台发起的退款是否同步到 PayWay，并检查部分退款金额与订单余额是否一致。订阅业务还需要关注续费通知、扣款失败、客户主动取消和付款方式更新。只测试一次普通信用卡付款，无法证明周期账单可以长期稳定运行。
对于保存支付方式的场景，应使用支付服务商提供的令牌机制，并明确客户授权、删除支付方式和隐私政策。API 方式的服务器安全责任较高，不应把支付凭据写进主题文件或公开代码仓库。
与其他支付和订阅扩展如何配合
若商城还在评估不同的付款字段或特殊线下付款流程，可参考本站的 WooCommerce Custom Payment Gateway；如果需要管理订阅计划、续费订单和取消规则，则应结合 WooCommerce Subscriptions。支付网关处理资金，订阅扩展管理周期，两者的兼容性和回调顺序需要一并验证。
常见问题
为什么部分卡组织无法付款？
确认 Westpac 商户账户是否开通对应卡种。产品默认支持范围不代表每个商户账户都自动具备全部权限。
能否在订单后台做部分退款？
官方产品说明支持全额和部分退款，实际结果仍需在测试环境核对 PayWay 交易记录。
是否兼容区块结账？
当前产品说明列出 Checkout Block 和经典结账支持，但旧安装包仍应在实际主题和结账环境中测试。
下载旧资源前的安全检查
官方资料参考：Westpac PayWay API 官方文档。实际安装前应以当前产品页面、维护状态和站点环境要求为准。
原资源表中的文件较早，当前官方产品已更新支付流程和兼容范围。下载破解版或 nulled 文件后，先在测试环境验证 API 认证、结账、退款、订阅续费和 HPOS 订单存储，不要直接连接真实商户账户。支付数据涉及高风险信息，正式上线前应完成安全评估和小额真实交易验证。
