通用约定

请求格式、鉴权、签名与响应结构。

传输协议

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

公共请求参数

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

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

请求结构

{
  "parMerCode": "填⼊分配的主商户号",
  "merAcct": "填⼊分配的商户账号",
  "productType": "填⼊产品类型枚举值",
  "merserialNo": "商户流⽔号",
  "signature": "填⼊签名值"
}
字段说明
respCode返回码，见各接口附录
respMsg返回信息
data回显请求信息及我司交易流水号 transCode
datarow业务结果域（部分接口返回）

响应结构

{
  "respCode": "参见各产品返回码",
  "respMsg": "参见各产品返回信息",
  "data": {},
  "datarow": {}
}

加签说明

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

完整 Java 版代码示例 Demo 由服务方提供，请向服务方索取后替换入参；注意 productType 须按接口要求上送。

计费说明

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

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

具体以各产品附录为准。

简介
产品接口文档说明与接入指引。
营业执照 OCR
识别营业执照上的文字信息。