申请数据

>礼品卡接口简介 / Synopsis

聚合礼品卡集合购物、视频、旅游、时令、食品、影视等全国通用的预付费礼品卡,无跨地域限制;多种礼品卡组合可被广泛用于商务馈赠、节日送礼、员工福利、活动奖品等,是不可多得的时尚便捷礼品。

>礼品卡接口优势 / Advantage

  • 整合一手资源,直连发卡通道;
  • 安全稳定,API实时发货;
  • 全面值可定,实体卡/电子卡都可选购;
  • 24小时技术、客服支持,查单、激活(冻结)、追溯全搞定。

>礼品卡接口活动场景 / Scenarios

>礼品卡接口案例 / Example

用户通过完成任意任务领取积分,所获积分可立即兑换礼品卡类奖品。

查看示例大图>>

用户通过输入#xxx#指令获取优惠券,进入购物车,立即兑换礼品卡类奖品。

查看示例大图>>

>礼品卡接口种类 / Type

100元 200元 300元 500元 1000元
50元 100元 200元 300元 500元
800元 1000元
30元 50元 100元 200元 300元
500元 800元 1000元
30元 50元 100元 200元 500元
1000元
50元 100元 200元 500元 1000元
50元 100元 200元 300元 500元
1000元
种类 一个月 三个月 六个月 十二个月
30元 90元 180元 360元
20元 56元 169元
20元 58元 108元 198元
19元 54元 198元
  • 礼品卡接口简介
  • 礼品卡接口优势
  • 礼品卡接口活动场景
  • 礼品卡接口案例
  • 礼品卡接口种类
  • 商品列表
  • 发货
  • 订单详情
  • 历史订单查询
  • 账户变动记录
  • 错误码参照
  • 示例代码
  • 其他相关
接口地址:http://v.juhe.cn/giftCard/products
支持格式:json/xml
请求方式:http get/post
请求示例:http://v.juhe.cn/giftCard/products
接口备注: 查询可购买的礼品卡的列表,及每个礼品卡对应的productId。如需了解各礼品卡的使用,请点击
请求参数说明:
名称 类型 必填 说明
  ​dtype string 返回的格式,json或xml,默认json
  key string 您申请到的APPKEY
返回参数说明:
名称 类型 说明
  ​error_code int 返回码
  reason string 返回说明
  result string 返回结果集
JSON返回示例:
/* 示例内容有所省略,请以您取到的最新数据为准 */
/* 商品ID基本不会变,请做好长期的缓存 */
/* 如果您的需求量较大,请告诉我们您需要的卡种以便我们备货 */
/* 如需各卡的使用说明,请访问 http://code.juhe.cn/docs/1944 */

{
  "reason": "查询成功",
  "result": [
    {
      "productId": "100026", /* 商品ID基本不会变,请做好长期的缓存 */
      "name": "携程任我行100元", /* 商品名 */
      "value": "100.00", /* 商品面值 */
      "discount": "0.998" /* 默认折扣,如您需求量较大,可议 */
    },
    {
      "productId": "100027",
      "name": "携程任我行500元",
      "value": "500.00",
      "discount": "0.998"
    },
   {
      "productId": "310001",
      "name": "阳澄湖牌出口有机大闸蟹298型", /* 优惠价格,企业采购,请咨询客服*/
      "value": "298.00",
      "discount": "0.900"
    },
    此处有省略
  ],
  "error_code": 0
}
接口地址:http://v.juhe.cn/giftCard/buy
支持格式:json/xml
请求方式:http get/post
请求示例:http://v.juhe.cn/giftCard/buy?key=您申请到的APPKEY
接口备注: 发货,会先尝试从您的聚合余额里扣款,请保证余额充足(不可透支);卡密一经售出,非卡密本身质量原因,概不退换
请求参数说明:
名称 类型 必填 说明
  ​dtype string 返回的格式,json或xml,默认json
  key string 您申请到的APPKEY
  num int 购买数量,1-100
  productId string 商品ID,从商品列表查询
  userOrderId string 您的订单号,50个字符内,允许数字、字母、下划线,请保证单号唯一
  sign string MD5(openId+key+num+userOrderId),加号不是MD5的内容
返回参数说明:
名称 类型 说明
  ​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
}
接口地址:http://v.juhe.cn/giftCard/order
支持格式:json/xml
请求方式:http get/post
请求示例:http://v.juhe.cn/giftCard/order?key=您的APPKEY&juheOrderId=123233123312
接口备注: 根据聚合订单号查询订单详情
请求参数说明:
名称 类型 必填 说明
  dtype string 返回的格式,json或xml,默认json
  key string 您申请到的APPKEY
  juheOrderId string 聚合订单号
  userOrderId string 用户订单号,两个订单号提供一个即可
返回参数说明:
名称 类型 说明
  error_code int 返回码
  reason string 返回说明
  result string 返回结果集
JSON返回示例:
{
  "reason": "查询成功",
  "result": {
    "juheOrderId": "JHDN201603120014351360130234",
    "productId": "100022",
    "submitTime": "2016-03-12 00:15:34",
    "message": "发货成功",
    "cards": [
      {
        "cardNo": "tV47z0fgrFuyAu1an1vi95ciamcrypted",
        "cardPws": "udOpZ+ESspfRWjaEAjidliamcrypted",
        "expireDate": "20181119"
      }
    ]
  },
  "error_code": 0
}
接口地址:http://v.juhe.cn/giftCard/orders
支持格式:json/xml
请求方式:http get/post
请求示例:http://v.juhe.cn/giftCard/orders?key=您的APPKEY&begin=2016-02-09&end=2016-03-09
接口备注: 查某段时间内的订单信息
请求参数说明:
名称 类型 必填 说明
  ​dtype string 返回的格式,json或xml,默认json
  key string 您申请到的APPKEY
  begin string 开始的日期,如:2016-02-09(默认为2016-02-09 00:00:00)
  end string 结束的日期,如:2016-03-09(默认为2016-03-09 00:00:00)
返回参数说明:
名称 类型 说明
  ​error_code int 返回码
  reason string 返回说明
  result string 返回结果集
JSON返回示例:
{
  "reason": "查询成功",
  "result": [
    {
      "juheOrderId": "JHDN201603141423227380180045",
      "productId": "100058",
      "submitTime": "2016-03-14 14:23:22",
      "message": "抱歉:此商品暂无库存"
    },
    {
      "juheOrderId": "JHDN201603141550086498910071",
      "productId": "100022",
      "submitTime": "2016-03-14 15:51:17",
      "message": "发货成功"
    }
  ],
  "error_code": 0
}
接口地址:v.juhe.cn/giftCard/account.php
支持格式:json/xml
请求方式:get/post
请求示例:v.juhe.cn/giftCard/account.php?key=key&begin=2016-02-09&end=2016-08-01
接口备注: 查询因本业务而引起的余额变动记录
请求参数说明:
名称 类型 必填 说明
  dtype string 返回的格式,json或xml,默认json
  key string 您申请到的APPKEY
  begin string 开始日期,如:2016-01-01
  end string 结束日期,如:2016-07-01
返回参数说明:
名称 类型 说明
  error_code int 返回码
  reason string 返回说明
  result string 返回结果集
JSON返回示例:
{
  "reason": "查询成功",
  "result": [
    {
      "juheOrderId": "JHDN2016033434341122540472",
      "price": "1000.00",
      "time": "2016-03-11 22:54:04",
      "type": "0" /*0表示扣款,1表示加款*/
    },
    {
      "juheOrderId": "JHDN201342343258",
      "price": "999.00",
      "time": "2016-03-11 22:55:32",
      "type": "0"
    },
    有省略
  ],
  "error_code": 0
}
服务级错误码参照(error_code):
  错误码 说明
  223100 系统错误
  223101 参数输入错误
  223102 您的余额不足
  223103 库存不足
系统级错误码参照:
  错误码 说明 旧版本(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) 具体错误代码
完整教学代码示例:
  语言 标题 提供者 时间
  other 各礼品卡使用说明文档 JoneDwyane 2016-03-12 16:15:40
  PHP 礼品卡的解密方法 小糊涂仙 2016-07-26 17:11:08
  JAVA 礼品卡卡信息的解密方法 小糊涂仙 2016-07-26 10:47:43
  other 礼品卡接口常见问题的说明 小糊涂仙 2016-09-29 14:38:53
  C# 礼品卡卡信息的解密方法 test 2016-07-26 11:28:00
  C# 礼品卡卡信息解密WindowsUI版 test 2017-04-01 18:27:36
常见问题:
  内容 详细
  常见问题: http://www.juhe.cn/qa/index/1495436887
其他相关内容
  内容 详细
  技术支持: info@juhe.cn
  联系电话: 0512-62391880
  在线客服QQ: 800076065