地址与公共参数

  • 本文档提供测试环境可供系统商测试使用,测试完成请使用正式环境地址;
  • 公共参数是指每个接口都需要使用到的请求参数;

请求地址

环境 请求地址
测试环境 https://bankliquidation-sxpay-test.wechatpark.com/gateway
正式环境 https://heshanpay-openapi.wechatpark.com/gateway
测试环境—图片上传地址 https://bankliquidation-sxpay-file-test.wechatpark.com/gateway
正式环境—图片上传地址 https://heshanpay-file.wechatpark.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
}
  • 平台方错误
{
    "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
    }
    

results matching ""

    No results matching ""