GEP提供集成所需API，代理商可使用POST方法向GEP系统发送HTTPS请求并接收对应的响应。下文介绍具体的

请求地址

请求格式

https://{Host}/{Path}

示例：

https://member-test-api.gepholding.com/api/user/account/queryUserBalanceAccount

地址说明

属性 描述
Host 指定环境的服务器域名：
• 测试环境：https://member-test-api.gepholding.com
• 正式环境：https://api.gepholding.com
Path API访问路径，从具体API的请求URL模块获取
示例：/api/user/account/queryUserBalanceAccount

请求方式

  • Method: POST
  • Content-Type:
    • 默认：application/x-www-form-urlencoded
    • 文件上传接口：application/data-form

默认错误描述(errorMsg)为中文，如需英文请在请求头设置：Accept-Language: en-US

请求报文

请求报文参数

序号 域名 变量名 必填 字段类型 备注
01. 版本号 version M String(6) 1.0.0
02. 证书编号 certificateId M String(19) GEP提供给商户的证书编号
03. 代理商编号 agentNo M String(19) GEP提供给代理商的唯一编号
04. 数据类型 dataType M String(8) JSON
05. 加密数据 dataContent M String(2048) 1. 按dataType组装数据
2. 进行base64编码后RSA私钥加密（参考加密说明）
06. 商户号 userNo M String(19) GEP提供给商户的唯一编号
07. API类型 apiType C String(19) 1：代理商请求
2：商户请求（默认值）
值为1时代理商编号必填
08. 文件 file File C 仅文件上传接口需要，文件传输方式可参考demo

请求报文示例

{
  "agentNo": "5182210819000222768",
  "certificateId": "2211211448000022579",
  "dataType": "JSON",
  "version": "1.0.0",
  "dataContent": "30efd89292d3cc9bf3cb66f8ff2cbb859bf931c7b26f096e11f53e76fb41918a1d41a61e40a115305547e9c67462565f193de3ceff0e0f052082ce0d363a314f548c37566868fbf2b09aa4b7bdb80e4340dec2c473af6cc95f16418c7791f3c17852ecd342794bbd474c6705cf6db55119aae7deb9011313387fd692d36f2fd0"
}

响应报文

响应报文参数

序号 域名 变量名 必填 字段类型 备注
01. 成功标识 success M String(8) 返回true、false
02. 错误描述 errorMsg O String(512) 错误描述，success为fasle时不为空,具体见各接口附录错误码
03. 返回结果信息 result O String(2048) success为false时为空，其他时候不为空,结果信息参考个接口 结果信息result 说明，解密方法参考 解密说明
04. 代理商编号 agentNo M String(19) GEP提供给商户的唯一编号
05. 证书编号 certificateId M String(19) GEP提供给商户的证书编号
06. 商户号 userNo C String(19) GEP提供给商户的唯一编号

响应报文示例

  • 成功示例

    {
"agentNo": "5182210819000222768",
"certificateId": "2211211448000022579",
"errorMsg": "受理成功",
"result": "5cd975b1419175fa907106ae89acf75448336299f9e6ac01ecc7f1e869a062d93c368824d5b207874316f21f7cc8b5623954b34bff1d15a019a51d55724914d99e654298f62aa5aa582c6282872d3a98653bc1c72cd2b5275da1ea3e7afc5dc835ec9eb817e62161ce216f7f69faae906a54cfb9cc08e62dbdb7151a6d1253b7",
"success": true
}

  • 失败示例

    {
"agentNo": "5182210819000222768",
"certificateId": "2211211448000022579",
"errorMsg": "邮箱已被使用",
"success": false
}
作者：陈花枪  创建时间：2024-08-15 10:15
最后编辑：陈花枪  更新时间：2025-09-04 11:36