支付功能如何划分联调边界
支付功能上线后出现的纠纷,常见原因不是开发能力,而是联调阶段双方对谁负责什么没有写清。商户资质由谁申请、测试在哪个环境做、签名失败和回调丢失由谁排查、重复通知怎么处理、订单金额以哪一方数据为准,这些若只停留在口头,出问题时容易各执一词。以下按五个环节拆分职责,适用于需要接入第三方支付渠道的建站项目;具体接口规则以所选支付服务方的实际文档为准。
商户申请与资质材料由谁推进
商户号、结算账户、经营资质等材料的准备与提交,通常需要企业主体配合,开发方难以代办。合同中宜协商写明:哪一方负责在支付服务方平台提交申请,哪一方负责准备营业执照、法人信息、结算账户等材料,材料补齐的截止时间如何记录。
申请结果不由双方控制,因此条款宜写成过程义务而非结果承诺:提交时间、补件响应时间、被退回后的处理方式。审批周期与所需材料以支付服务方实际要求为准,签约前应向该服务方核对,不宜在合同中写死天数。
申请未通过时的项目安排也要提前写明,例如支付功能暂缓、其余模块是否照常验收,避免整站进度被单一环节拖住而责任不清。
测试环境与生产环境分开约定
支付联调应先在支付服务方提供的测试环境或沙箱中完成,合同中可写明测试环境由哪一方开通、测试账号由谁保管、测试用的商户配置与生产配置如何隔离。
生产环境不应进行重复付款测试。真实金额的交易需要业务授权,合同中宜写明:生产环境只做经授权的小额验证或由业务方自行操作,开发方不得自行发起真实扣款。若确需验证,应记录授权人、金额上限、操作时间与退款安排。
测试完成后,测试账号、沙箱密钥的停用与清理也应列为交付核对项,避免测试凭据留在生产配置中。
签名、回调与幂等的责任划分
签名生成与验签失败、支付回调接收与应答、回调丢失后的主动查询,这三类问题容易在双方之间来回推。合同中可按环节划分:开发方负责按接口文档实现签名与验签逻辑、提供回调接收地址并记录回调日志;合同中可约定由哪一方提供密钥与证书材料,并确认回调地址可被外部访问。
幂等处理宜在合同中明确由哪一方负责实现:同一笔支付通知重复到达时,系统按订单号做去重,不重复发货、不重复记账。验收时可准备重复通知的模拟请求,核对系统是否只处理一次。
排查责任也要写清:出现签名失败时,先由哪一方提供日志、在多少时间内响应,再由双方共同定位。响应时间宜写成双方商定的工作时段内的具体时限,不写固定时限承诺。
订单核对以哪一方数据为准
对账口径要提前定:站内订单表记录什么字段,支付服务方后台记录什么字段,两边按订单号与交易流水号如何匹配。建议在合同附件中列出核对字段,例如订单号、支付金额、支付状态、支付时间、退款状态。
金额精度与状态流转要写明:金额以分为单位存储还是以元存储、舍入规则如何、支付成功与发货完成是否为两个独立状态。验收时可抽取若干笔测试交易逐笔比对,差异记录在核对表中。
出现单边账时的处理流程也应约定:由哪一方发起查询、查询结果如何留档、多久核对一次。这些属于流程约定,具体周期由双方按业务量商定。
联调记录与交付核对
联调过程应留下可核对的记录,建议每个环节登记:测试用例编号、使用的环境、预期结果、实际结果、发现人与处理状态。签名失败、回调超时、重复通知等异常分支都要有对应用例,而不只测支付成功一条路径。
交付时核对以下材料是否齐全:支付配置说明、密钥与证书的交接方式、回调地址清单、对账字段说明、异常处理流程。凭据类材料宜与文档分开交接,并约定交接后的保管责任。
上线后若更换支付服务方或调整商户配置,原联调记录可作为回归核对的底稿。具体接口能力与限制,签约前应向所选支付服务方逐项确认,不以来回口头描述为准。
