欢迎接入鸿途Pay。本文档面向已开通商户的技术对接人员，涵盖商户进件、支付、提现、投诉、分账、退款、结算等接口与功能说明。
| 项目 | 说明 |
|---|
| 请求地址 | https://htpay.wenshuabao.cn/ （商户后台站点地址） |
| 提交格式 | application/x-www-form-urlencoded |
| 返回格式 | JSON，字符编码 UTF-8 |
| 签名算法 | RSA（SHA256WithRSA，推荐）/ MD5（兼容旧商户） |
| 时间戳 | timestamp，10 位秒级整数，与服务器时间偏差需在 5 分钟以内 |
| 字段名 | 变量名 | 必填 | 说明 |
|---|
| 商户ID | pid | 是 | 商户后台分配的商户编号 |
| 当前时间戳 | timestamp | 是 | 10 位整数，单位秒 |
| 签名类型 | sign_type | 否 | RSA（默认）或 MD5 |
| 签名字符串 | sign | 是 | 按 签名规则 计算 |
| 字段名 | 变量名 | 说明 |
|---|
| 状态码 | code | 0 表示成功，其它值表示失败 |
| 提示信息 | msg | 失败时返回错误原因 |
| 业务数据 | data | 具体接口返回的数据 |
| 时间戳 / 签名 | timestamp、sign、sign_type | 成功响应自动附带，建议验签后再处理业务 |
| code | 含义 | 处理建议 |
|---|
| 0 | 成功 | 正常处理 data |
| -1 | 业务错误 | 根据 msg 调整请求参数或订单状态 |
| -3 | 签名校验失败 | 核对密钥、待签名字符串拼接顺序与时间戳 |
| -4 | 参数缺失 / 路由不存在 | 检查请求参数与接口地址 |
1、登录 鸿途Pay 商家后台，在「设置 - API 信息」中查看商户 ID；
2、点击【生成商户RSA密钥对】，妥善保存商户私钥，并将平台公钥用于返回/通知验签；旧版 MD5 商户直接使用页面展示的商户密钥；
3、密钥属于敏感信息，严禁出现在前端页面、APP 安装包或公开代码仓库中。
