平台简介与接入流程
中合智付开放平台（HarmoPay Open Platform）面向企业客户提供标准化的金融级资金结算与行业解决方案接口，支持单笔转账到银行卡、账户可用余额查询、银行电子回单下载、合作油站消费与额度调配、增值税电子专用发票等核心业务。
企业系统通过标准的 HTTPS POST 协议与平台统一网关通信，采用 RSA2 / SM2 数字签名机制保障通信安全。
一、接入准备
在正式发起接口调用前，企业需完成以下准备工作：
- 商务签约：与中合智付签署技术服务合作协议，完成企业实名认证；
- 开通业务权限：根据企业实际业务场景，申请开通因公转账或物流加油等对应的产品能力；
- 银行账户划款授权：涉及企业银行账户出资结算的，在企业开户行完成账户划款授权签约。
二、开发者凭证
入驻完成后，企业可在商户后台获取并配置以下接入凭据：
| 凭证名称 | 字段名 | 说明 |
|---|---|---|
| 商户号 | merchantId | 平台分配的企业商户编号，代表交易记账主体 |
| 应用访问 ID | accessId | 开放平台分配的接入应用标识，用于网关鉴权 |
| 商户私钥 | merchantPrivateKey | 接入方自行生成的 RSA2 或 SM2 私钥，用于请求加签 |
| 商户公钥 | merchantPublicKey | 接入方在控制台上传登记，平台用于验证请求签名 |
| 平台公钥 | platformPublicKey | 从控制台下载，接入方用于验证平台响应与回调通知的签名 |
安全提示
商户私钥仅部署于接入方服务端，严禁存放在前端页面、App 或小程序等客户端源码中。
三、快速开始
接入平台标准接口分为四个步骤：
text
1. 构造请求参数 ➔ 2. 生成数字签名 ➔ 3. 发送 HTTPS 请求 ➔ 4. 接收异步通知（可选）1. 构造请求参数
请求分为公共请求参数与业务参数：
- 公共参数（如
accessId、method、timestamp、signType等）作为外层 JSON 字段； - 具体业务参数统一放入
bizContent字段中（作为 JSON 字符串）。
2. 生成数字签名
将除 signType 和 signData 外的全部公共参数按参数名字典序（ASCII）拼接为待签名串，使用商户私钥签名并 Base64 编码后填入 signData。详见签名与验签。
3. 发起调用与校验响应
通过 HTTPS POST 向网关发送 JSON 报文：
- 测试环境网关：
https://test.harmopay.com/gateway/v1 - 生产环境网关：
https://openapi.harmopay.com/gateway/v1
收到平台同步响应后，先检查 resCode（000000 表示受理成功），再使用平台公钥验证返回报文的真实性。详见协议说明。
4. 接收异步结果通知
对于异步处理的交易（如转账到卡、油站扣款），平台在银行处理完成后，主动向商户在下单时指定的 notifyUrl 推送结果。接入方验证平台签名无误后完成本地业务处理，并应答纯文本 SUCCESS。详见异步通知机制。