• 231
  • 4063
  • 62

通用礼品卡接口文档

聚合数据 支持HTTPS

集于各商家实体卡和会员卡的API虚拟卡,可用于线上/下消费、移动支付。

  • 按实际订单计费

¥ *** 价格详情请联系客服

  • API文档
  • 错误码参照
  • 示例代码
  • 联系我们
立即调用
接口地址:http://v.juhe.cn/giftCard/buy
返回格式:json/xml
请求方式:http get/post
请求示例:http://v.juhe.cn/giftCard/buy?key=您申请到的APPKEY
接口备注:发货,会先尝试从您的聚合余额里扣款,请保证余额充足(不可透支);卡密一经售出,非卡密本身质量原因,概不退换;正式使用后建议个人中心绑定IP白名单。***如果发货过程中,遇到http网络状态异常或错误码返回系统异常10014,请务必通过订单查询接口检测订单或联系客服,不要直接做失败处理,避免造成不必要的损失!!!

请求参数说明:

名称 必填 类型 说明
  ​dtype string 返回的格式,json或xml,默认json
  key string 您申请到的APPKEY
  num int 购买数量,1-10
  productId string 商品ID,从商品列表查询
  rechargeNo string 充值卡绑定的号码,某些商品可能需要绑定手机号、卡号等,具体事宜请联系客服咨询
  userOrderId string 您的订单号,50个字符内,允许数字、字母、下划线,请保证单号唯一
  sign string MD5(openId+key+num+userOrderId),加号不是MD5的内容,32位小写

返回参数说明:

名称 类型 说明
  ​error_code int 返回码
  reason string 返回说明
  result string 返回结果集

JSON返回示例:

/*请注意,发货时可能会返回“此商品暂无库存”,请联系我们客服并告知您需要的卡种类、数量,以便我们备货*/
/*请注意,余额不足的情况下频繁请求接口会被封号*/


{
  "reason": "成功的返回",
  "result": {
    "juheOrderId": "JUHE14575079213274NN", /*聚合订单号*/
    "userOrderId": "MYORDER123456", /*您的订单号*/
    "num": 1, /*本次发货数量*/
    "deduction":100, /*最终扣费总额*/
    "cards": [ /*卡信息*/
      {
        "cardNo": "DCDCDCJUHEDCDC", /*DES加密后的卡号,解密方法见:http://code.juhe.cn/docs/1943、
http://code.juhe.cn/docs/1945*/
        "cardPws": "YOYOYOYOCKN", /*DES加密后的卡密,解密方法见:http://code.juhe.cn/docs/1943、
http://code.juhe.cn/docs/1945*/
        "expireDate": "20251231" /*失效时间*/
      }
    ]
  },
  "error_code": 0
}

服务级错误码参照(error_code):

  错误码 说明
  223100 系统错误
  223101 参数输入错误
  223102 您的余额不足
  223103 库存不足
  223104 没有权限购买该卡或超过最大限额

系统级错误码参照:

  错误码 说明 旧版本(resultcode)
  10001 错误的请求KEY 101
  10002 该KEY无请求权限 102
  10003 KEY过期 103
  10004 错误的OPENID 104
  10005 应用未审核超时,请提交认证 105
  10007 未知的请求源 107
  10008 被禁止的IP 108
  10009 被禁止的KEY 109
  10011 当前IP请求超过限制 111
  10012 请求超过次数限制 112
  10013 测试KEY超过请求限制 113
  10014 系统内部异常(调用充值类业务时,请务必联系客服或通过订单查询接口检测订单,避免造成损失) 114
  10020 接口维护 120
  10021 接口停用 121

错误码格式说明(示例:200201):

  2 002 01
  服务级错误(1为系统级错误) 服务模块代码(即数据ID) 具体错误代码

完整教学代码示例:

  语言 标题 提供者 时间

常见问题:

  内容 详细
  常见问题: http://www.juhe.cn/qa/index/1542368238

联系我们

  内容 详细
  接口测试: API测试工具
  技术支持: info@juhe.cn
  联系电话: 4008827715-6067
  在线客服QQ: 800076065

猜你喜欢

现在注册,百款接口免费测试

免费注册