• 231
  • 4325
  • 65

通用礼品卡接口文档

聚合数据 支持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):

  错误码 说明

系统级错误码参照:

  错误码 说明 旧版本(resultcode)

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

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

完整教学代码示例:

  语言 标题 提供者 时间

常见问题:

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

联系我们

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

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

免费注册