API接入
  • 娱乐充值
  • 卡密购买
  • 订单查询
  • 购卡查询
  • 余额查询
  • 商品查询
  • 异步通知
娱乐充值
各大游戏、腾讯服务、视频会员等娱乐产品在线直充API
服务状态:正常

接口地址: http://api.qianyou.cn:11140/UserOrderController/receiveUserOrder

支持格式:json

请求方式:http get/post

请求示例:http://api.qianyou.cn:11140/UserOrderController/receiveUserOrder?

userNo=xxx&userOrderId=xxx&goodsId=xxx&totalMoney=xxx&account=xxx&userTimeStamp=xxx&customerIp=xxx&sign=xxx

请求参数说明:

名称 类型 必须 字段说明
userNo string 用户编号,注册www.qianyou.cn的手机号码
userOrderId string 用户的订单号(最长32位)
goodsId int32 商品编号,具体参照商品查询接口返回
totalMoney int32 充值总金额(产品面值*充值数量)
account string 充值账号,URLEncode UTF8
userTimeStamp int64 订单创建时间,Unix时间戳,精确到毫秒
customerIp string 此IP需填写充值账号的IP,而不是接口调用方IP
accountType string 账号类型,具体参照商品查询接口返回,URLEncode UTF8
accountTypeNo string 账号类型编号,具体参照商品查询接口返回
wayName string 充值方式名称,具体参照商品查询接口返回,URLEncode UTF8
wayCode string 充值方式编码,具体参照商品查询接口返回,URLEncode UTF8
gameName string 充值游戏名称,具体参照商品查询接口返回,URLEncode UTF8
gameCode string 充值游戏编码,具体参照商品查询接口返回,URLEncode UTF8
areaName string 充值区域名称,具体参照商品查询接口返回,URLEncode UTF8
areaCode string 充值区域编码,具体参照商品查询接口返回,URLEncode UTF8
serverName string 充值服务器名称,具体参照商品查询接口返回,URLEncode UTF8
serverCode string 充值服务器编码,具体参照商品查询接口返回,URLEncode UTF8
customerArea string 充值账号所在区域(省市),URLEncode UTF8
gameAccount string 游戏账号,目前只有魔兽世界需要,URLEncode UTF8
sign string 签名,md5(userNoXXXuserOrderIdXXXgoodsIdXXXtotalMoneyXXX
accountXXXuserTimeStampXXXkey),计算签名时不需要URLEncode

返回示例:

{

 "msg": "操作成功",

 "code": "1008",

 "userOrderId": "590300113",

 "userNo": "18766565251",

 "platOrderId": "991844"

}

名称 类型 字段说明
msg string 返回说明
code int32 返回码
userOrderId string 用户提交的订单号
userNo string 用户编号,注册www.qianyou.cn的手机号码
platOrderId string 千游订单号
错误码 说明
9998 参数错误
9999 系统错误
1000 用户信息不存在
1001 用户状态异常
1002 时间戳错误
1003 签名错误
1004 产品不存在
1005 系统繁忙
1006 产品不可用
1007 订单已存在
1008 操作成功
1009 产品维护
1011 用户API权限已关闭
1012 用户手动提交权限已关闭
1013 IP限制
1014 充值数量非法
1015 游戏信息错误
1016 充值账号限制
1018 不可充值的产品
1019 用户非法
1021 账号类型编码错误
1022 充值方式错误
1023 区服错误
1024 账号类型错误
1025 游戏名称错误
语言 标题 提供者 时间
JAVA 娱乐充值接口调用示例 qianyou 2017-10-16 10:04
C# 娱乐充值接口调用示例 qianyou 2017-10-16 10:04
PHP 娱乐充值接口调用示例 qianyou 2017-11-13 09:56
卡密购买
网游点卡、视频会员等各类娱乐产品API购买电子卡密
服务状态:正常

接口地址: http://api.qianyou.cn:11140/receiveUserBuyCardOrder

支持格式:json

请求方式:http get/post

请求示例:http://api.qianyou.cn:11140/receiveUserBuyCardOrder?

userNo=xxx&userOrderId=xxx&goodsId=xxx&chargeAmount=xxx&userTimeStamp=xxx&sign=xxx

请求参数说明:

名称 类型 必须 字段说明
userNo string 用户编号,注册www.qianyou.cn的手机号码
userOrderId string 用户的订单号(最长32位)
goodsId int32 商品编号,具体参照商品查询接口返回
chargeAmount int32 购买数量
userTimeStamp int64 订单创建时间,Unix时间戳,精确到毫秒
sign string 签名,md5(userNoXXXuserOrderIdXXXgoodsIdXXXchargeAmountXXXuserTimeStampXXXkey),计算签名时不需要URLEncode

返回示例:

{

 "msg": "操作成功",

 "code": "1008",

 "userOrderId": "590300113",

 "userNo": "18766565251",

 "platOrderId": "991844",

 "cards": [

  {

   "cardNumber": "m390",

   "cardPwd": "H5Kcj7HOxHs="

  },

  {

   "cardNumber": "m136",

   "cardPwd": "G0QKwtfM6LU="

  }

 ]

}

名称 类型 字段说明
msg string 返回说明
code int32 返回码
userOrderId string 用户提交的订单号
userNo string 用户编号,注册www.qianyou.cn的手机号码
platOrderId string 千游订单号
card list 购买卡密信息
cardNumber string 卡号
cardPwd string 卡密,需要des解密获得真实卡密,解密key是接口key的前8位
错误码 说明
9998 参数错误
9999 系统错误
1000 用户信息不存在
1001 用户状态异常
1002 时间戳错误
1003 签名错误
1004 产品不存在
1005 系统繁忙
1006 产品不可用
1007 订单已存在
1008 操作成功
1009 产品维护
1011 用户API权限已关闭
1013 IP限制
1018 不可充值的产品
1019 用户非法
1027 库存不足
1028 超过单次最大购买数量
1030 余额不足
1037 购卡处理中
语言 标题 提供者 时间
JAVA 卡密购买接口调用示例 qianyou 2017-10-16 10:04
C# 卡密购买接口调用示例 qianyou 2017-10-16 10:04
订单查询
订单管理,数据实时呈现
服务状态:正常

接口地址: http://api.qianyou.cn:11140/UserOrderController/queryOrder

支持格式:json

请求方式:http get/post

请求示例: http://api.qianyou.cn:11140/UserOrderController/queryOrder?

userNo=xxx&orderId=xxx&sign=xxx

请求参数说明:

名称 类型 必须 字段说明
userNo string 用户编号,注册www.qianyou.cn的手机号码
orderId string 用户提交的订单号
sign string 签名, md5(userNoXXXorderIdXXXkey),计算签名时不需要URLEncode

返回示例:

{

 "msg": "操作成功",

 "code": "1008",

 "orderId": "590297586",

 "orderState": "2",

 "account": "449067578888"

}

名称 类型 说明
msg string 返回说明
code int32 返回码
orderId int32 用户提交的订单号
orderState int32 充值状态(0充值中1成功2失败)
account string 充值账号
错误码 说明
9998 参数错误
9999 系统错误
1000 用户信息不存在
1003 签名错误
1008 操作成功
1010 订单不存在
1013 IP限制
语言 标题 提供者 时间
JAVA 订单查询接口调用示例 qianyou 2017-10-16 10:04
C# 订单查询接口调用示例 qianyou 2017-10-16 10:04
PHP 订单查询接口调用示例 qianyou 2017-11-13 09:56
购卡查询
购卡订单查询,数据实时呈现
服务状态:正常

接口地址: http://api.qianyou.cn:11140/queryBuyCardOrder

支持格式:json

请求方式:http get/post

请求示例: http://api.qianyou.cn:11140/queryBuyCardOrder?

userNo=xxx&orderId=xxx&sign=xxx

请求参数说明:

名称 类型 必须 字段说明
userNo string 用户编号,注册www.qianyou.cn的手机号码
orderId string 用户提交的订单号
sign string 签名, md5(userNoXXXorderIdXXXkey),计算签名时不需要URLEncode

返回示例:

{

 "msg": "操作成功",

 "code": "1008",

 "orderId": "590297586",

 "orderState": "1",

 "cards": [

  {

   "cardNumber": "m136",

   "cardPwd": "G0QKwtfM6LU="

  },

  {

   "cardNumber": "m390",

   "cardPwd": "H5Kcj7HOxHs="

  }

 ],

}

名称 类型 说明
msg string 返回说明
code int32 返回码
orderId int32 用户提交的订单号
orderState int32 订单状态(0充值中1成功2失败)
card list 购买卡密信息
cardNumber string 卡号
cardPwd string 卡密,需要des解密获得真实卡密,解密key是接口key的前8位
错误码 说明
9998 参数错误
9999 系统错误
1000 用户信息不存在
1003 签名错误
1008 操作成功
1010 订单不存在
1013 IP限制
语言 标题 提供者 时间
JAVA 购卡查询接口调用示例 qianyou 2017-10-16 10:04
C# 购卡查询接口调用示例 qianyou 2017-10-16 10:04
余额查询
实时查看剩余金额,清晰记录消费订单
服务状态:正常

接口地址:http://api.qianyou.cn:11140/UserOrderController/queryUserBalance

支持格式:json

请求方式:http get/post

请求示例:http://api.qianyou.cn:11140/UserOrderController/queryUserBalance?

userNo=xxx&sign=xxx

请求参数说明:

名称 类型 必须 字段说明
userNo string 用户编号,注册www.qianyou.cn的手机号码
sign string 签名,md5(userNoXXXkey),计算签名时不需要URLEncode

返回示例:

{

 "msg": "操作成功",

 "code": "1008",

 "balance": "1000.00",

 "userNo": "18362678098"

}

名称 类型 说明
msg string 返回说明
code int32 返回码
balance double 用户余额
userNo string 用户编号,注册www.qianyou.cn的手机号码
错误码 说明
9998 参数错误
9999 系统错误
1000 用户信息不存在
1003 签名错误
1008 操作成功
1013 IP限制
语言 标题 提供者 时间
JAVA 余额查询接口调用示例 qianyou 2017-10-16 10:04
C# 余额查询接口调用示例 qianyou 2017-10-16 10:04
PHP 余额查询接口调用示例 qianyou 2017-11-13 09:56
商品查询
快速便捷查询商品的名称、价格、运营商等信息
服务状态:正常

接口地址:http://api.qianyou.cn:11140/UserGoodsController/userQueryGoodsInfo

支持格式:json

请求方式:http get/post

请求示例:http://api.qianyou.cn:11140/UserGoodsController/userQueryGoodsInfo?

userNo=xxx&sign=xxx

请求参数说明:

名称 类型 必须 字段说明
userNo string 用户编号,注册www.qianyou.cn的手机号码
sign string 签名,md5(userNoXXXkey),计算签名时不需要URLEncode

返回示例:

{

 "msg": " 查询成功",

 "code": "1008",

 "result": [

{

 "goodsId": “1134”,/*商品编码*/

 "goodsName": "腾讯逆战按元直充",/*商品名称*/

 "goodsType": "5",/*产品类型(5直充产品,6官方卡密)*/

 "faceValue": "100",/*面值*/

 "amount": "10-1000", /*充值数量*/

 "province": "全国",/*库存地区*/

 "accountType": “腾讯增值服务”,/*账号类型*/

 "accountTypeNo": “tecentzz11”,/*账号类型编码*/

 "games": [

{

 "gameName": "逆战点",/*游戏名称*/

 "gameCode": "逆战点", /*游戏编码*/

 "gameAreas": [

{

 "areaName": " 网通区", /*游戏区域*/

 "areaCode": "网通区",/*区域编码*/

 "gameServers": [

 "serverName": "网通区",/*服务器名称*/

 "serverCode": " wtq"/*服务器编码*/

}]

}],

"gameWays": [

{

 "wayName": "Q币",/*充值方式*/

 "wayCode": "Q币"/*充值方式编码*/

}]

}]

}]

}


名称 类型 说明
msg string 返回说明
code int32 返回码
result list 返回结果集
错误码 说明
9998 参数错误
9999 系统错误
1000 用户信息不存在
1003 签名错误
1008 操作成功
1013 IP限制
1017 操作频繁
语言 标题 提供者 时间
JAVA 商品查询接口调用示例 qianyou 2017-10-16 10:04
C# 商品查询接口调用示例 qianyou 2017-10-16 10:04
PHP 商品查询接口调用示例 qianyou 2017-11-13 09:56
异步通知
订单成功或者失败后通知用户
服务状态:正常

接口地址:当订单状态是最终状态时,由我司发起异步通知请求, 贵司接收到请求并验证无误时需返回“success”(小写), 如无返回值或返回其他则认为贵司没有接收请求成功或者验证失败 (异步通知超时时间设置为30秒,请确保服务器通信正常)。 同一笔订单我司最多发起5次异步通知,如果5次都未成功,将终止发起异步通知请求。

支持格式:json

请求方式:http get/post

请求示例:http://ip:port/xxx?

userNo=xxx&orderId=xxx&orderState=xxx&sign=xxx

请求参数说明:

名称 类型 必须 字段说明
userNo string 用户编号,注册www.qianyou.cn的手机号码
orderId string 用户订单号
orderState int32 订单状态(1充值成功2充值失败)
sign string 签名,md5(userNoXXXorderIdXXXorderStateXXXkey),计算签名时不需要URLEncode

返回示例:

success

错误码 说明
9998 参数错误
9999 系统错误
1000 用户信息不存在
1001 用户状态异常
1002 时间戳错误
1003 签名错误
1004 产品不存在
1005 系统繁忙
1006 产品不可用
1007 订单已存在
1008 操作成功
1009 产品维护
1010 订单不存在
1011 用户API权限已关闭
1012 用户手动提交权限已关闭
1013 IP限制
1014 充值数量非法
1015 游戏信息错误
1016 充值账号限制
1017 操作频繁
1018 不可充值的产品
1019 用户非法
1020 游戏名称、编号不可为空
1021 账号类型编码错误
1022 充值方式错误
1023 区服错误
1024 账号类型错误
1025 游戏名称错误

正在开发,敬请期待!

千游互娱平台-游戏点卡充值 视频会员直充 卡密购买 API接口