自研系统要接入有赞支付,先确定交易和资金分别由谁管,再查已经确认开放的接口。官网方案可以帮助判断方向,具体接口、产品和版本以接口文档和开通结果为准。
本章用于准备接入需求和验收,不提供未经核实的支付、分账接口路径、参数或回调示例。当前核验的公开资料尚不足以形成完整的开放接口调用手册。
一、先选择系统之间的责任边界
| 接入目标 | 需要先回答的问题 |
|---|---|
| 自研商城收款 | 谁创建订单,支付结果写回哪里,履约和退款由哪个系统发起 |
| ERP同步 | 同步的是商品、订单、退款、资金账单,还是供应商关系;同步方向和主数据归属是什么 |
| 财务对账 | 要取得明细还是汇总,按订单、入账还是银行出款日期入账 |
| 多方分账 | 谁维护规则与参与方,接口能否覆盖该场景,是否还需后台人工确认 |
| 外部平台资金归集 | 谁配置平台结算账户,是否只是入金,订单数据怎样进入计算范围 |
例如,供应链分账要求SKU匹配供应商和价格,并固化历史结算信息。接入ERP时应保留规格级标识和变更时间,不能只同步一个商品名称或当前成本价。
有赞云文档实拍 · 如采用自用型应用,先按有赞云文档选部署方式,再确认支付接口开放范围 · 查看有赞云文档来源
二、取得接口文档后逐项确认
以下是工程实施检查项,不表示有赞已开放表中每一项接口。
| 项目 | 必须确认的内容 |
|---|---|
| 产品与开通 | 文档对应哪种产品、版本、商户资格及权限 |
| 环境与认证 | 正式或测试环境、授权方式、凭据保管和失效处理 |
| 对象编号 | 商家订单、支付、退款、分账和资金流水怎样关联 |
| 金额 | 单位、精度、币种、舍入及退款可退范围 |
| 状态 | 哪些是中间态、哪些是最终态,查询与通知如何结合 |
| 重复请求 | 是否提供幂等能力,重复提交应得到什么结果 |
| 通知 | 验签、重试、乱序、重复以及漏通知时的补查方式 |
| 退款与逆向 | 支持哪些售后方式,已结算或已分账之后怎样处理 |
| 对账 | 可取得的账单范围、时间口径和延迟 |
| 错误 | 可重试与不可重试错误,人工介入所需编号 |
支付扩展能力、订单接口和分账接口不应只因名称包含“支付”就互相替代。进入有赞云文档中心定位对应产品,再取得具体已开放接口说明。
三、用业务结果验收
对每个实际支持的流程,核对正常付款、失败付款、重复通知、部分退款、全额退款、结算前后退款、分账余额不足和账单核对。仅测试所选方案已确认支持的事项,不把未开放能力列为通过。
至少让业务人员能用一组关联编号,从自研订单查到支付和退款,再查资金账单;涉及供应链时再关联SKU、供应商与原结算价格。若只能在开发日志看到“请求成功”,还不能证明资金业务已经完成。
四、交付时保留什么
保存具体接口文档链接及版本、授权范围、关键编号映射、状态处理、对账方法和异常联系人。对支付超时、通知重试等问题,应能通过查询和账单还原最终结果,避免重复发起付款、分账或退款。
业务可先阅读本手册对应操作章节确认规则,技术再依据正式接口契约实现,最后用订单、账单与银行结果共同验收。

