share

有赞支付接入准备:自研系统分工、接口确认与验收

自研系统要接入有赞支付,先确定交易和资金分别由谁管,再查已经确认开放的接口。官网方案可以帮助判断方向,具体接口、产品和版本以接口文档和开通结果为准。

本章用于准备接入需求和验收,不提供未经核实的支付、分账接口路径、参数或回调示例。当前核验的公开资料尚不足以形成完整的开放接口调用手册。

一、先选择系统之间的责任边界

接入目标需要先回答的问题
自研商城收款谁创建订单,支付结果写回哪里,履约和退款由哪个系统发起
ERP同步同步的是商品、订单、退款、资金账单,还是供应商关系;同步方向和主数据归属是什么
财务对账要取得明细还是汇总,按订单、入账还是银行出款日期入账
多方分账谁维护规则与参与方,接口能否覆盖该场景,是否还需后台人工确认
外部平台资金归集谁配置平台结算账户,是否只是入金,订单数据怎样进入计算范围

例如,供应链分账要求SKU匹配供应商和价格,并固化历史结算信息。接入ERP时应保留规格级标识和变更时间,不能只同步一个商品名称或当前成本价。

有赞云文档实拍 · 如采用自用型应用,先按有赞云文档选部署方式,再确认支付接口开放范围

有赞云文档实拍 · 如采用自用型应用,先按有赞云文档选部署方式,再确认支付接口开放范围 · 查看有赞云文档来源

二、取得接口文档后逐项确认

以下是工程实施检查项,不表示有赞已开放表中每一项接口。

项目必须确认的内容
产品与开通文档对应哪种产品、版本、商户资格及权限
环境与认证正式或测试环境、授权方式、凭据保管和失效处理
对象编号商家订单、支付、退款、分账和资金流水怎样关联
金额单位、精度、币种、舍入及退款可退范围
状态哪些是中间态、哪些是最终态,查询与通知如何结合
重复请求是否提供幂等能力,重复提交应得到什么结果
通知验签、重试、乱序、重复以及漏通知时的补查方式
退款与逆向支持哪些售后方式,已结算或已分账之后怎样处理
对账可取得的账单范围、时间口径和延迟
错误可重试与不可重试错误,人工介入所需编号

支付扩展能力、订单接口和分账接口不应只因名称包含“支付”就互相替代。进入有赞云文档中心定位对应产品,再取得具体已开放接口说明。

三、用业务结果验收

对每个实际支持的流程,核对正常付款、失败付款、重复通知、部分退款、全额退款、结算前后退款、分账余额不足和账单核对。仅测试所选方案已确认支持的事项,不把未开放能力列为通过。

至少让业务人员能用一组关联编号,从自研订单查到支付和退款,再查资金账单;涉及供应链时再关联SKU、供应商与原结算价格。若只能在开发日志看到“请求成功”,还不能证明资金业务已经完成。

四、交付时保留什么

保存具体接口文档链接及版本、授权范围、关键编号映射、状态处理、对账方法和异常联系人。对支付超时、通知重试等问题,应能通过查询和账单还原最终结果,避免重复发起付款、分账或退款。

业务可先阅读本手册对应操作章节确认规则,技术再依据正式接口契约实现,最后用订单、账单与银行结果共同验收。

参考

更新于