通用约定

传输协议、请求应答格式、鉴权、签名与完整的 demo 演示提供，一站式接入公共约定。

传输协议

  • 使用 HTTPS（生产环境）
  • 请求格式：application/x-www-form-urlencoded
  • 响应格式：application/json
  • 字符编码：UTF-8
  • 默认超时：10s

公共请求参数

除各接口特有参数外，以下字段为多数接口共用：

参数描述是否必填说明
parMerCode主商户号是商户一级账号，由服务方提供
merAcct商户账号是商户二级账号，由服务方提供
appKey商户密钥否加签密钥，入参不传，仅用于本地加签
productType产品类型是见产品类型字典
merserialNo商户流水号否最长 36 位，建议上送
signature签名值是报文加签后的值

请求结构

所有接口均为 HTTP POST，请求头：

Content-Type: application/x-www-form-urlencoded

请求体为 键值对（key=value，多个参数用 & 连接），不是 JSON。appKey 仅用于本地加签，不要放入请求体。

Body 示例（字段因接口而异，完整示例见各接口页「请求示例」）：

parMerCode=主商户号&merAcct=商户账号&productType=PMVI&merserialNo=商户流水号&companyName=企业名称&regNo=统一社会信用代码&signature=加签后的签名值

curl 示例

curl -X POST 'https://{服务方提供的地址}' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -d 'parMerCode=主商户号' \
  -d 'merAcct=商户账号' \
  -d 'productType=PMVI' \
  -d 'merserialNo=商户流水号' \
  -d 'companyName=企业名称' \
  -d 'regNo=统一社会信用代码' \
  -d 'signature=加签后的签名值'

响应结构

响应为 JSON（Content-Type: application/json）：

{
  "respCode": "00",
  "respMsg": "认证一致，成功",
  "data": {},
  "datarow": {}
}
字段说明
respCode返回码，见各接口附录
respMsg返回信息
data回显请求信息及我司交易流水号 transCode
datarow业务结果域（部分接口返回）

加签说明

  1. 将参与签名的参数按约定规则排序拼接
  2. 使用服务方提供的 appKey 进行加签
  3. 将签名结果填入 signature 字段

接口调用示例已加密保护

请输入访问密码以查看 Java（Hutool）/ Python（requests）/ Go 完整 Demo

注意 productType 须按各接口要求上送。

计费说明

各接口附录「返回码及信息字典」中标注了是否计费。一般而言：

  • 核验/识别成功或不一致但已明确结论的码值可能计费
  • 参数错误、验签失败、系统异常等通常不计费

具体以各产品附录为准。

简介
认证产品接口文档说明与接入指引，新接入必读。
对账说明
月度对账单发送规则、核对方式，以及预付费与后付费商户的结算注意事项。