支付接入入门：流程、状态与异常处理

给数字商品接上收款能力，技术难点不在调通一个接口，而在把订单状态管清楚。状态一旦混乱，就会出现重复发货、用户已付未到账、退款后权益未回收等问题。下面按流程设计、状态机、异常处理、对账四个部分说明。

流程设计：先定边界再定接口

接入前先明确三件事：卖什么（一次性买断、周期订阅、按量扣减）、谁收款（自有账户还是多方分账）、何时交付（付款前预占还是付款后发放）。这三件事决定订单模型。典型链路是：创建订单、发起支付、接收支付结果通知、校验并更新订单、交付权益、记录流水。创建订单时要生成业务侧唯一订单号并持久化，金额、币种、商品标识在创建时锁定，后续流程只读不改，避免中途被篡改。

状态机：少状态、单向流转

订单状态不宜多，常见为待支付、支付中、已支付、已关闭、已退款。流转必须单向，禁止从已关闭跳回已支付。支付中状态用于处理用户跳转后结果未知的窗口期，此时不应重复发起新支付，而应查询或等待通知。状态更新要幂等：同一笔支付结果重复到达时，只有第一次产生状态迁移，其余仅记录。交付动作与状态迁移绑定，建议用“状态迁移成功后再交付”的顺序，交付失败则进入补偿队列，而不是回滚支付状态。

异常处理：把不确定当常态

支付结果通知可能延迟、重复、乱序，甚至先到失败后到成功。处理原则是：以主动查询为准，通知只作为触发；校验金额与订单号一致后才更新；对超时未决订单设置定时查询任务；对已支付但交付失败的订单单独标记并告警。用户侧要给出明确反馈：支付处理中显示等待提示并允许稍后查看，不要反复引导重新付款。退款同理，退款申请、退款处理中、退款完成三态要清晰，权益回收放在退款完成后执行。

对账与安全注意事项

每日做一次业务流水与支付流水的比对，差异分为三类：本地有支付侧无（多为未真正支付）、支付侧有本地无（多为通知丢失）、金额不一致（严重，需立即排查）。差异要有处理台账，不能只告警不闭环。安全方面：金额与商品信息以服务端为准，客户端传参一律校验；回调需验签并校验来源；密钥与证书不入代码库，按环境隔离；日志中不记录完整卡号等敏感信息；对高频创建订单做限流，防止刷单。

上线前的自检

用沙箱环境跑通正常支付、支付取消、支付超时、重复通知、金额篡改、退款全流程六类用例；确认幂等键设计覆盖创建与通知；确认补偿任务有重试上限与人工介入入口；确认对账脚本可在无人值守下产出差异清单。把这些做完，收款链路才算真正可用。