地址与公共参数
- 本文档提供测试环境可供系统商测试使用,测试完成请使用正式环境地址;
- 公共参数是指每个接口都需要使用到的请求参数;
请求地址
环境 | 请求地址 |
---|---|
测试环境 | https://hzgd-openapi-test.51fubei.com/gateway |
正式环境 | https://hzgd-openapi.51fubei.com/gateway |
公共参数
根据需求分公共参数和业务参数,其中公共参数字段每个接口固定不变, 请求参数根据业务需求决定。
业务参数需写在公共参数的content
字段中
以下为公共参数:
参数 | 类型 | 是否必填 | 最大长度 | 描述 |
---|---|---|---|---|
app_id | string | 是 | 32 | 移动支付平台分配给接入平台的服务商唯一的 ID,请向相关对接负责人获取 |
method | string | 是 | 128 | 接口名称 |
sign | string | 是 | 256 | 请求参数的签名串 |
version | string | 是 | 3 | 调用的接口版本,默认且固定为:1.0 |
content | string | 是 | - | 请求参数的集合,最大长度不限,除公共参数外所有请求参数(业务参数)都必须放在这个参数中传递 |
业务请求参数根据业务需求决定, 参见接口详细说明
全局异常
- 权限异常
{
"error_code": "-102",
"error_message": "权限不足",
"success": false
}
- 签名异常
{
"error_code": "-100",
"error_message": "无效签名",
"success": false
}
- 参数异常
{
"error_code": "-101",
"error_message": "无效参数",
"success": false
}
- 服务器异常
{
"error_code": "-200",
"error_message": "服务器异常",
"success": false
}
- 公共异常
{
"error_code": "-103",
"error_message": "通用错误",
"success": false
}
- 支付中状态
{
"error_code": "100",
"error_message": "用户正在支付中。。。",
"success": false
}