支付与物流接口对接清单

支付、物流和商城交易应该怎样划分责任？

支付负责资金动作及其结果，物流负责运输或履约事件，商城负责订单及消费者可见状态。三者之间有协作关系，但一个系统的确认不能替代另一个系统的事实。付款成功不代表仓库已经出库；快递轨迹出现签收，也不必然意味着商城售后责任已经结束。

对接前先列需要核对的具体业务：新付款、支付查询、关闭尝试、退款、发货、物流查询和通知处理。实际范围根据所选渠道及合同确认。不要把所有渠道统称为一个“支付接口”或“物流接口”，因为身份主体、参数、回调和结果查询方式可能不同，适配也应分别验收。

客户需提供有权使用的商户或物流账号、接口版本说明、测试条件和对应业务岗位。账号资料应在受控配置或约定的安全交接渠道管理，不能放入源码提交、公开需求单或截图。测试与生产的账号、网络和回调地址应能明确区分，避免一个环境收到另一环境的业务通知。

已有源码入口可以证明哪些范围？

消费者订单具有支付查询、支付尝试、结果刷新、关闭及储值支付入口；本地模拟入口与真实渠道商户配置需要分别核验。

源码有平台与商城物流设置，以及商城、门店和供应商物流账号控制器；配置与订单发货业务需要分开验收。

这些事实依据固定源码提交，说明可以追踪的业务与配置入口。它们不证明某个客户商户已开通、所有渠道参数都适用，或真实扣款、退款与发货已完成。配置保存成功与渠道业务成功应在验收记录里分开，避免将控制台截图当作支付联调报告。

渠道设置还应核对有效范围：平台、商城、门店或供应商的配置谁可以维护，实际交易使用哪一份配置。不能因为某个管理员可打开设置页，就让所有交易都使用其账号。配置变更需要判断对正在进行的支付尝试和物流任务有什么影响，保留必要的版本和操作审计。

支付尝试和订单金额应该怎样核对？

一次订单可能产生不同支付尝试。支付尝试应关联当前订单与明确金额，渠道返回时需要找到对应尝试，并核对商户主体、币种、金额和业务状态。不能仅凭前端跳转页显示“成功”就更新订单付款结果，也不能把不同尝试的回执混成一笔付款。

订单提交后应保留成交依据。外部渠道使用的金额单位与商城内部约定可能不同，需要明确转换点，并在边界值与退款场景验证。商品价格变化、优惠券状态变化或页面再次报价，不应改变已经发生的资金动作。详情可对照金额与精度文档。

支付关闭、订单取消和支付晚到可能产生竞争。取消订单的本地操作，不等于渠道必定没有扣款。应按真实渠道约定查询和处理资金结果，再决定订单或售后动作。用渠道查询结果确认退款状态与资金去向。

回调地址与结果查询应怎样验收？

回调来自外部系统，接收端需要按官方接口说明核对身份、签名或其他验证条件，并确认消息所属账号和业务范围。具体校验算法应使用所选渠道当前规范，不依据别的渠道示例推断。公网入口、HTTPS、代理路径和请求内容的处理方式都可能影响校验，须在实际环境验证。

回调可能重复、延迟或没有按业务顺序到达。处理规则应允许查询当前结果，识别已经应用的事件，并防止旧状态覆盖终止结果。验收不只发送一个成功通知，还应覆盖非法来源、错误金额、未知业务编号和重复通知，观察是否产生任何未经授权的状态或资金动作。

结果查询是异常恢复的重要入口。通知缺失时，应能依据原业务编号查到渠道结果，再与本地状态比较。查询失败也要有明确处理岗位，不能因为无法获取结果就将付款默认标为失败。运行资料应说明哪些状态仍未知，以及谁有权进一步处理。

退款与物流售后怎样分别留下证据？

退款需要关联原付款、原订单行和批准范围。部分退款、重复退款申请和退款结果未知，应分别验证。渠道接受退款申请不一定表示资金已完成退回；商城应表达当前真实状态，并留下后续查询位置。涉及金额拆分时，使用冻结交易依据，不用当前商品价格推算退款。

物流售后可能涉及退货收件、入库质检和原包裹关联。退货运单存在，不表示商品已回到可售库存；消费者已拿到退款，也不能作为仓库入库证据。业务负责人应说明这些结果如何影响售后状态，技术实现再据此决定状态转换。

将支付结果和运输轨迹分开对账，可以更早发现资金正确但订单显示错误、包裹已经发出但商城未记录等情况。对账资料应使用脱敏编号，不向日志或公开截图暴露完整地址、电话或支付凭据。需要处理个人资料时，应限定岗位和使用目的。

联调清单应覆盖哪些关键检查？

按下表记录客户项目的实际环境、渠道账号与验证结果。

检查类别	支付侧核验	物流侧核验	所需工程资料
主体及范围	商户、应用、交易范围与授权	账号所属商城、门店或供应商	接口版本、账号负责人、权限确认
配置隔离	测试与真实商户分别配置	测试轨迹与真实面单分别核对	环境标识、回调入口、变更记录
正常路径	发起、查询、确认、关闭与退款	发货、包裹关联与轨迹查询	脱敏业务单及两侧查询结果
异常路径	超时、重复、晚到、金额不符	面单作废、部分发货、轨迹乱序	原操作编号、拒绝原因、恢复决定
运行交接	未知资金结果的处置岗位	未推进任务及售后差异的处置岗位	查询说明、告警范围、升级路径

执行顺序应从配置和权限开始，再覆盖业务正常与异常，最后查看消费者界面和后台账目。某一项条件无法获得时，应保留未执行状态与原因。不能为了完成清单，使用未经授权的真实付款、真实收件资料或不存在的渠道结果。

哪些条件会影响报价与上线安排？

现有接口版本、账号是否可用、测试环境完整程度、历史交易处理范围和双方配合岗位都会影响工作量。若需要新增适配、补查工具或运行告警，应单独写入工程范围。渠道运营规则变化时，也可能需要重新核对，不能将一次沙箱联调扩展成永久兼容承诺。

使用ERP与WMS需求模板记录账号范围和异常契约，结合支付工程文档、物流工程文档核对源码入口，再通过系统集成服务讨论实际联调。整体数据责任与验收方法见系统集成专题。