皓臻支付 - 支付开放接口文档- 统一支付· 退款· 分账· 转账API

皓臻支付 - 支付开放接口文档：统一支付、退款、分账、转账API

随着网站商城、会员系统、SaaS平台和线上交易业务的发展，越来越多的企业需要将支付功能直接集成到自己的业务系统中。统一支付、订单退款、交易分账和商家转账，已经成为现代支付系统的重要功能模块。

皓臻支付（HaozPay）支付开放接口方案，重点围绕多渠道支付接入和交易流程自动化展开，为开发者提供统一管理支付业务的技术思路。 企业可以根据自身经营需求和实际获得的接口权限，建设更加规范、高效的在线交易系统。

一、💳 统一支付API：简化多渠道收款

统一支付API的核心作用，是将不同支付渠道的接入逻辑进行标准化处理，减少开发人员分别维护多个支付接口的工作量。

在典型的聚合支付架构中，网站可通过统一的下单接口提交交易信息，由支付服务系统根据商户配置及渠道权限处理支付请求。

主要涉及以下功能：

• 统一创建订单： 提交商户订单号、支付金额、支付方式等必要信息。
• 支付状态查询： 根据订单编号查询交易处理结果。
• 异步支付通知： 接收经过验证的支付结果，更新本地订单状态。
• 订单关闭处理： 对符合条件的未支付订单执行关闭操作。

支付方式可以根据实际渠道权限支持扫码支付、网页支付等不同场景，具体能力应以正式接口文档为准。

二、🔄 退款API：完善订单售后流程

退款API主要用于处理客户取消订单、商品退货或服务终止等场景。

开发者可以将退款功能接入企业订单管理系统，由具备相应权限的操作人员或业务流程发起退款申请。

标准退款流程通常包括退款申请、退款状态查询和退款结果确认。

需要注意，退款申请被受理，并不代表资金已经退还成功。 系统应以支付渠道最终确认的退款状态为依据，更新业务订单。

对于部分退款，还需要核对原始交易金额、累计退款金额及剩余可退款额度，防止超额退款或重复退款。

三、📊 分账API：实现多方收益分配

分账API适用于平台型业务、多商户合作、服务佣金结算等场景。

例如，某平台完成一笔交易后，需要按照业务协议将部分交易资金分配给符合条件的合作商户。通过分账接口，可以提交订单信息、分账金额和收款方信息，由具备相应资质的支付机构按照规则处理。

皓臻支付公开的Go SDK已列出分账申请和分账回退相关功能。实际分账比例、接收方范围、可分配金额及结算限制，应以商户获得的渠道权限为准。

Go Packages

分账与普通转账不同，通常需要与原始交易建立对应关系，并满足支付渠道的分账规则。对于已经完成分账的订单，还需要考虑退款时的资金回退处理。

四、💰 转账API：满足企业资金划付需求

转账API主要面向符合条件的企业资金划付场景，例如业务款项支付、合作费用发放等。

典型转账处理涉及收款方身份核验、转账金额校验、交易申请和最终状态查询。

转账与商户账户提现属于不同业务，不能直接混用。是否可以向个人或企业账户转账，需要根据支付渠道的产品权限、收款方资质及资金用途确定。

对于皓臻支付，独立转账API的具体开放范围、收款对象和交易限额，需要以正式授权文档为准。

五、🔐 API接口安全与签名验证

支付接口涉及真实资金交易，安全机制是开发接入过程中不可忽视的环节。

皓臻支付公开的SDK采用RSA相关签名与验签机制。开发者应妥善保存商户私钥，使用平台提供的可信公钥验证通知真实性，并通过HTTPS保护数据传输。

此外，所有资金类接口都需要做好订单幂等控制、金额校验、异常重试和交易结果查询。

特别是退款、分账和转账业务，发生网络超时后不能直接认定交易失败，更不能随意更换业务单号重复提交，应优先查询原交易的最终状态，防止重复资金操作。

六、⚙️ 皓臻支付API适用于哪些业务？

对于独立网站、线上商城、会员系统及企业服务平台，统一支付API可以连接商品订单与支付流程，减少多渠道重复开发。

对于需要管理退款的电商系统，可以通过退款接口完善售后业务；对于存在合作商户收益分配需求的平台，可以在开通相应权限后接入分账能力。

开发过程中，应先完成测试环境验证，再逐步检查生产环境中的交易通知、异常订单、退款及资金对账结果。

七、总结

皓臻支付开放接口的技术价值，在于将支付收款、订单管理、退款处理及符合条件的资金分配业务整合到统一的开发体系中。

对于企业开发者而言，支付系统不仅需要完成交易，更需要保证订单状态准确、资金操作可追溯、异常交易能够及时处理。

合理使用统一支付、退款、分账及获得授权的转账接口，有助于企业减少重复开发工作，提高交易管理效率，为网站商城、数字服务及平台型业务建立更加规范的支付基础设施。