地址与公共参数
- 本文档提供测试环境可供系统商测试使用,测试完成请使用正式环境地址;
- 公共参数是指每个接口都需要使用到的请求参数;
请求地址
公共参数
根据需求分公共参数和业务参数,其中公共参数字段每个接口固定不变, 请求参数根据业务需求决定。
业务参数需写在公共参数的 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
}
- 平台方错误
{
"error_code": "-300",
"error_message": "平台方错误",
"success": false
}
- 支付失败
{
"error_code": "-301",
"error_message": "支付失败",
"success": false
}
- 退款失败
{
"error_code": "-301",
"error_message": "退款失败",
"success": false
}
- 清算方无效
{
"error_code": "-201",
"error_message": "清算方无效",
"success": false
}
- 商户无效
{ "error_code": "-202", "error_message": "商户无效", "success": false }
- 子商户无效
{ "error_code": "-203", "error_message": "子商户无效", "success": false }
- 渠道号无效
{ "error_code": "-205", "error_message": "渠道号无效", "success": false }
- 重复订单号
{ "error_code": "-206", "error_message": "重复订单号", "success": false }
订单不存在
{ "error_code": "-207", "error_message": "订单不存在", "success": false }
文件未生成
{ "error_code": "-209", "error_message": "文件未生成", "success": false }
- 文件类型错误
{ "error_code": "-210", "error_message": "文件类型错误", "success": false }
无效费率
{ "error_code": "-211", "error_message": "无效费率", "success": false }
重复绑卡
{ "error_code": "-214", "error_message": "重复绑卡", "success": false }
暂未绑卡
{ "error_code": "-215", "error_message": "暂未绑卡", "success": false }
请求过于频繁,请稍候重试
{ "error_code": "-221", "error_message": "请求过于频繁,请稍候重试", "success": false }
支付类型错误
{ "error_code": "-222", "error_message": "支付类型错误", "success": false }