给网站加一个“立即支付”按钮，看起来像前端功能，真正容易出错的却是支付结果如何回到商户系统。付款完成后浏览器可能没有跳回成功页，支付平台的通知也可能延迟或重复；如果系统只凭前端页面显示“成功”就发货、开通服务或记账，订单状态就可能与实际交易不一致。
AI 可以帮助整理支付流程和测试用例，但不应把它生成的代码直接连到生产商户账号。开始开发前，先把订单状态、核验责任、退款流程和异常处理写清楚，再按所用支付机构当前的接口文档实现和联调。
先画清楚网站订单的状态变化
一个简单的在线订单通常会经历“待支付—支付处理中—已支付”，也可能进入“已关闭”“退款处理中”或“已退款”等状态。具体状态名称应与业务和支付机构接口对应。每一次状态变化都要有可追溯的来源：由谁发起、平台返回什么结果、商户系统核验了哪些字段、何时完成。
- 用户提交订单后，商户服务端根据商品、套餐或服务规则重新计算金额，生成自己的唯一订单号，初始状态记为待支付。
- 服务端按当前支付产品文档创建支付请求，保存商户订单号、支付机构交易号和本次请求记录；不要把私钥、API 密钥放进浏览器页面。
- 用户完成支付后，浏览器跳转页可以告诉用户“正在确认”，但不要把跳转参数本身当作到账依据。
- 服务端接收支付机构的结果通知，按官方文档验签，并核对商户订单号、商户或应用标识、订单金额及交易状态与本地记录一致。
- 只有通过核验、状态满足业务要求后，才按规则把订单推进到已支付并执行一次交付、开通或通知动作。
支付回调要考虑重复、延迟和丢失
支付平台可能因网络或商户应答问题重新发送通知。订单更新必须具备幂等性：同一笔订单已经完成处理时，再次收到相同结果不能重复发货、重复增加余额或重复开通服务。先读取并检查订单当前状态，再以可靠的事务或并发控制完成状态更新和后续业务动作。
不能只等通知。通知延迟、服务器暂时不可用或回调地址配置错误时，应按支付机构文档提供的查询方式核对订单状态，并设计人工可追踪的异常订单处理流程。用户看到“支付中”时，应能解释如何刷新或联系客服，而不是引导其反复付款。
回调接口要使用服务端方式处理，不依赖普通用户登录态，也不能相信请求中的金额或订单号未经核实。微信支付官方文档强调对通知进行验签、校验商户侧订单信息并处理重复通知；支付宝官方资料也要求核验通知签名、订单号、金额、商户身份和应用标识。开发时请以正在使用的具体支付产品文档为准，参考微信支付回调通知注意事项、微信支付 Native 支付通知说明和支付宝开放平台异步通知说明。
退款不要另起一条“改状态”捷径
先确认原订单已经支付成功，再按业务授权发起退款申请。系统应记录退款对应的原订单、退款金额、申请人、原因、支付机构返回的退款编号和最终状态。退款请求提交成功，不一定等于退款已经完成；页面提示和商户订单都应反映真实处理状态。若支持部分退款、多次退款或退款失败重试，要分别定义金额上限、重复提交规则和人工处理权限。
上线前按场景做联调验收
- 支付成功后，服务端核验通过，订单只完成一次交付。
- 用户取消、付款失败或超时，订单保持正确状态，不能误标已支付。
- 同一支付通知重复送达，系统只处理一次，后续仍能正常应答。
- 通知延迟或未收到时，可以通过支付机构的订单查询流程核实。
- 金额、商户号、应用标识或订单号与本地记录不一致时，系统拒绝发货并记录异常。
- 退款成功、退款失败、重复退款请求和部分退款分别有明确状态与日志。
- 测试环境回调地址可从外网访问；切换到生产前，检查域名、HTTPS、密钥和商户配置没有混用。
优先使用支付机构为对应产品提供的测试或联调环境，测试完成后确认没有把测试商户号、测试密钥或测试订单带入生产。不同产品的接口、通知应答和测试能力可能不同，不要照搬其他支付方式的实现细节。
让 AI 帮忙整理状态图和测试矩阵
请根据以下已确认的支付业务规则，整理一份订单状态转换表和验收测试矩阵。请区分用户浏览器返回、支付机构服务端通知、主动查询和退款结果；列出重复通知、延迟通知、金额不符、取消、退款失败等异常。不要编写或执行生产支付代码，不要猜测支付机构参数；缺少的规则标记为待确认。支付产品和版本：……；订单类型：……；成功后交付动作：……；可退款规则：……
再让开发人员逐项确认状态转换、服务端验签、订单金额来源、重复处理和退款权限，并用测试环境做实际联调。支付功能涉及真实交易与商户配置，AI 适合减少需求遗漏，不负责确认到账或批准上线；生产发布前要由项目负责人和技术人员共同核对正式账号与回调配置。
开发前准备好业务资料
向开发人员说明网站是电脑扫码、手机网页、公众号还是小程序支付，订单由谁创建，付款后交付什么，取消和退款由谁审批，以及需要哪些对账记录。提前确认商户账号、域名和支付产品的开通条件；不同渠道和产品的接入方式可能不同，不能仅凭 AI 生成的通用示例判断能否开通。
联调记录不要包含私钥、完整支付凭据或不必要的付款人资料。密钥应由商户安全地交给授权开发人员，并按支付机构文档保存在服务端配置中；测试截图或日志对外提供前先脱敏。
