支持HTTPS
中石化、中石油加油卡API接口技术接入。为企业提供加油卡API接口,通过接口自由实现PC端、H5、APP等方式接入。
为上万家企业与电商平台提供中国石化与中国石油加油卡的在线快速充值接口,商户通过接口自由实现PC端、H5、APP等方式充值,让车主用户在互联网时代免去寻找排队充值的烦恼。
中石化 | 常规面值 | 100元 | 500元 | 1000元 | ||
非常规面值 | 50元 | 200元 | ||||
中石油 | 常规面值 | 100元 | 200元 | 500元 | 1000元 |
适用于车主服务类平台/APP,为其用户提供汽车加油卡充值功能服务。
适用于各电商平台充值中心,增加加油卡在线充值服务。
可应用于各银行APP充值频道,以及汽车保险附属增值服务。
请求参数说明:
名称 | 必填 | 类型 | 说明 | |
---|---|---|---|---|
proid | 是 | int |
产品id:
10000(中石化50元加油卡) [暂不支持] 10001(中石化100元加油卡) 10002(中石化200元加油卡) 10003(中石化500元加油卡) 10004(中石化1000元加油卡) 10007(中石化任意金额充值) [暂不支持] 10008(中石油任意金额充值)) | |
cardnum | 是 | string | 充值数量(产品id为10007、10008时为具体充值金额(整数),其余产品id请传固定值1);注:中石油任意冲(产品id:10008)暂时只支持100\200\500\1000 | |
orderid | 是 | string | 用户自定义订单号,8-32位字母数字组合 | |
game_userid | 是 | string | 加油卡卡号,中石化:以100011开头的19位卡号、中石油:以90开头的16位卡号 | |
gasCardTel | 是 | string | 持卡人手机号码,可以填写一个固定格式的手机号码,如:18900000000;为了保证充值质量,中石油充值请传递加油卡账号的绑卡手机号。 | |
gasCardName | 否 | string | 持卡人姓名 | |
chargeType | 否 | int | 加油卡类型 (1:中石化、2:中石油;默认为1) | |
key | 是 | string | 在个人中心->我的数据,接口名称上方查看 | |
sign | 是 | string | 校验值,md5( OpenID+key+proid+cardnum+game_userid+orderid),OpenID在个人中心查询。加密结果转为32位小写 |
返回参数说明:
名称 | 类型 | 说明 | |
---|---|---|---|
error_code | int | 返回码 | |
reason | string | 返回说明 | |
result | string | 返回结果集 |
JSON返回示例:
{
"reason": "提交充值成功",
"result": {
"cardnum": "1", /*充值数量*/
"ordercash": "100", /*售价*/
"cardname": "全国加油卡", /*充值名称*/
"sporder_id": "S20141125221812330", /*天聚人合订单号*/
"game_userid": "100011320000991****", /*加油卡卡号*/
"game_state": "0", /*充值状态:0充值中 1成功 9撤销,刚提交成功的单子状态均为充值中*/
"uorderid": "S2014111111115" /*用户自定的订单号*/
},
"error_code": 0
}
请求参数说明:
名称 | 必填 | 类型 | 说明 | |
---|---|---|---|---|
orderid | 是 | string | 商家订单号,8-32位字母数字组合 | |
key | 是 | string | 在个人中心->我的数据,接口名称上方查看 |
返回参数说明:
名称 | 类型 | 说明 | |
---|---|---|---|
error_code | int | 返回码 | |
reason | string | 返回说明 | |
result | string | 返回结果集 |
JSON返回示例:
{
"reason": "查询成功",
"result": {
"cardname": "全国 中石化加油 固定面值加油卡 直充100元",/*商品名称*/
"game_userid": "1000119000002494353",/*加油卡卡号*/
"uordercash": "100.000",/*订单消耗金额*/
"sporder_id": "S17070400085272603302001",/*天聚人合订单号*/
"game_state": "9",/*状态 1:成功 9:失败 0:充值中*/
"err_msg": "只能给主卡且卡状态正常的加油卡充值"/*描述,订单失败时返回失败原因*/
},
"error_code": 0
}
请求参数说明:
名称 | 必填 | 类型 | 说明 | |
---|---|---|---|---|
天聚人合推送参数 | - | - | - | |
sporder_id | string | Y | 天聚人合订单号 | |
orderid | string | Y | 用户自定义的单号 | |
sta | int | Y | 充值状态1:成功 9:失败 | |
sign | string | Y | 校验值,md5(appkey+sporder_id+orderid) 32位小写,用于校验请求合法性 | |
err_msg | string | N | 状态描述信息(暂只支持油卡业务) |
返回参数说明:
名称 | 类型 | 说明 |
---|
JSON返回示例:
只有成功提交的订单才会有回调通知,如果提交订单是直接返回错误码,这部分单子不会发起回调通知。
详细说明可参考:https://www.tianjurenhe.com/codedoc/?type=mobile
处理成功请返回:success 或 任意字符串
重试机制:天聚人合数据在请求回调地址时,如果无任何内容返回或无响应,会重新发起最多3次,间隔3s左右
本回调推送内容格式适用于话费充值、油卡充值、流量充值等增值服务
如果需要状态回调的用户,如接口其他已经调试完毕,请将账号和回调地址发给在线客服,我们将回调地址配置线上。
请求参数说明:
名称 | 必填 | 类型 | 说明 | |
---|---|---|---|---|
key | 是 | string | 在个人中心->我的数据,接口名称上方查看 | |
orderid | 是 | string | 商家订单号,8-32位字母数字组合 | |
timestamp | 是 | string | 当前时间戳或随机数,如:1462502925 | |
sign | 是 | string | 校验值,md5( OpenID+key+orderid+timestamp),OpenID在个人中心查询 |
返回参数说明:
名称 | 类型 | 说明 | |
---|---|---|---|
error_code | int | 返回码 | |
reason | string | 返回说明 | |
result | string | 返回结果集 |
JSON返回示例:
{
"reason": "查询成功",
"result": {
"cardname": "全国 中石化加油 固定面值加油卡 直充100元",/*商品名称*/
"game_userid": "1000119000002494353",/*加油卡卡号*/
"uordercash": "100.000",/*订单消耗金额*/
"sporder_id": "S17070400085272603302001",/*天聚人合订单号*/
"game_state": "9",/*状态 1:成功 9:失败 0:充值中*/
"err_msg": "只能给主卡且卡状态正常的加油卡充值"/*描述,订单失败时返回失败原因*/
},
"error_code": 0
}
服务级错误码参照(error_code):
错误码 | 说明 | |
---|---|---|
208701 | 错误的充值类型 | |
208702 | 错误的充值金额/数量 | |
208703 | 加油卡卡号不能为空/错误/不支持 | |
208704 | 持卡人手机号码错误 | |
208706 | 校验值sign错误 | |
208707 | 当前账户可用余额不足 | |
208708 | 请求充值失败,请重试 | |
208709 | 充值失败,具体参照reason | |
208710 | 重复的订单号(近60天订单周期内单号不能重复)(需要自行进行二次确认,是否进行失败处理) | |
208711 | 加油卡不存在、挂失、副卡、卡号查询失败、查询不到结果等 | |
208712 | 订单号不存在 | |
208713 | 订单无效/受理失败 | |
208714 | 不合规范的订单号 | |
208716 | 创建订单失败 |
系统级错误码参照:
错误码 | 说明 | 旧版本(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) | 具体错误代码 |
完整教学代码示例:
语言 | 标题 | 提供者 | 时间 | |
Python | 加油卡在线充值接口实例 | 天聚人合 | 2020-12-21 17:26:20 | |
PHP | 加油卡充值示例 | 天聚人合 | 2020-12-21 17:24:04 | |
C# | 加油卡充值接口调用示例 | 天聚人合 | 2020-12-21 17:25:13 | |
Go | 加油卡充值接口调用示例 | 天聚人合 | 2020-12-21 17:24:40 | |
JAVA | 加油卡充值接口调用示例 | 天聚人合 | 2020-12-21 09:55:44 |
常见问题:
内容 | 详细 | |
---|---|---|
常见问题: | https://www.tianjurenhe.com/qa |
联系我们
内容 | 详细 | |
客服热线: | (0512) 6289 1011 | |
在线客服QQ: | 在线咨询 |
话费API接口技术接入服务,为企业提供话费API接口,通过接口自由实现PC端、H5、APP等方式接入。为中小型企业、商家活动、自媒体推广提供一站式话费营销服务,通过活动销售、赠送、积分兑换等方式营销话费,为企业客户提供安全、经济、专业的服务,从而帮助企业、商家拓展新客户并提高现有客户活跃度,提高客户对企业服务的满意度。
1元 | 2元 | 5元 | 10元 | 20元 | 30元 | |
50元 | 100元 | 200元 | 300元 | 500元 | ||
1元 | 2元 | 5元 | 10元 | 20元 | 30元 | |
50元 | 100元 | 200元 | 300元 | 500元 | ||
1元 | 2元 | 5元 | 10元 | 20元 | 30元 | |
50元 | 100元 | 200元 | 300元 | 500元 |
适用于各类含有话费充值中心模块的电商平台,快速实现手机话费直充功能。
适用于各种赠送手机话费活动、游戏抽奖以及其他客户关怀赠送等。
可应用于任何有话费充值功能需求的网站/APP。
请求参数说明:
名称 | 必填 | 类型 | 说明 | |
---|---|---|---|---|
phoneno | 是 | string | 手机号码 | |
cardnum | 是 | string | 充值金额,目前可选:1、2、5、10、20、30、50、100、200、300、500 | |
key | 是 | string | 在个人中心->我的数据,接口名称上方查看 |
返回参数说明:
名称 | 类型 | 说明 | |
---|---|---|---|
error_code | int | 返回码 | |
reason | string | 返回说明 | |
result | string | 返回结果集 |
JSON返回示例:
{
"reason": "允许充值的手机号码及金额",
"result": null,
"error_code": 0
}
请求参数说明:
名称 | 必填 | 类型 | 说明 | |
---|---|---|---|---|
phoneno | 是 | string | 手机号码 | |
cardnum | 是 | string | 充值金额,目前可选:1、2、5、10、20、30、50、100、200、300、500 | |
key | 是 | string | 在个人中心->我的数据,接口名称上方查看 |
返回参数说明:
名称 | 类型 | 说明 | |
---|---|---|---|
error_code | int | 返回码 | |
reason | string | 返回说明 | |
result | string | 返回结果集 |
JSON返回示例:
{
"reason": "成功",
"result": {
"cardid": "191404", /*卡类ID*/
"cardname": "江苏电信话费100元直充", /*卡类名称*/
"inprice": 98.4, /*购买价格*/
"game_area": "江苏苏州电信" /*手机号码归属地*/
},
"error_code": 0
}
请求参数说明:
名称 | 必填 | 类型 | 说明 | |
---|---|---|---|---|
phoneno | 是 | string | 手机号码 | |
cardnum | 是 | string | 充值金额,1、2、5、10、20、30、50、100等,请咨询客服了解具体情况 | |
orderid | 是 | string | 商家订单号,8-32位字母数字组合,由您自己生成 | |
operator | 否 | string | 运营商(移动yd,电信dx,联通lt),若不填,则以手机号运营商为准 | |
key | 是 | string | 在个人中心->我的数据,接口名称上方查看 | |
sign | 是 | string | 校验值,md5( OpenID+key+phoneno+cardnum+orderid),OpenID在个人中心查询 |
返回参数说明:
名称 | 类型 | 说明 | |
---|---|---|---|
error_code | int | 返回码 | |
reason | string | 返回说明 | |
result | string | 返回结果集 |
JSON返回示例:
{
"reason": "订单提交成功,等待充值",
"result": {
"cardid": "1900212", /*充值的卡类ID*/
"cardnum": "1", /*数量*/
"ordercash": 49.25, /*进货价格*/
"cardname": "江苏电信话费50元直充", /*充值名称*/
"sporder_id": "20141120174602882", /*天聚人合订单号*/
"uorderid":"2014123115121",/*商户自定的订单号*/
"game_userid": "18913515122", /*充值的手机号码*/
"game_state": "0" /*充值状态:0充值中 1成功 9撤销,刚提交都返回0*/
},
"error_code": 0
}
请求参数说明:
名称 | 必填 | 类型 | 说明 | |
---|---|---|---|---|
orderid | 是 | string | 商家订单号,8-32位字母数字组合,请填写已经成功提交的订单号 | |
key | 是 | string | 在个人中心->我的数据,接口名称上方查看 |
返回参数说明:
名称 | 类型 | 说明 | |
---|---|---|---|
error_code | int | 返回码 | |
reason | string | 返回说明 | |
result | string | 返回结果集 | |
success_time | string | 成功时间,只在订单状态成功时有值 |
JSON返回示例:
{
"reason": "查询成功",
"result": {
"uordercash": "5.000", /*订单扣除金额*/
"sporder_id": "20150511163237508",/*天聚人合订单号*/
"game_state": "1" /*状态 1:成功 9:失败 0:充值中*/
},
"error_code": 0,
"success_time": "2021-11-22 10:01:24"/*成功时间,只在订单状态成功时有值*/
}
请求参数说明:
名称 | 必填 | 类型 | 说明 |
---|
返回参数说明:
名称 | 类型 | 说明 |
---|
服务级错误码参照(error_code):
错误码 | 说明 | |
---|---|---|
208501 | 不允许充值的手机号码及金额 | |
208502 | 请求手机号和面值查询商品信息失败,请重试 | |
208503 | 运营商地区维护,暂不能充值 | |
208504 | 请求手机号和面值查询商品信息错误,具体请参考reason | |
208505 | 错误的手机号码 | |
208506 | 错误的充值金额 | |
208507 | 充值失败,具体请参考reason | |
208508 | 请求充值失败,请重试 | |
208509 | 错误的订单号 | |
208510 | 请求订单状态失败,请重试 | |
208513 | 查询订单失败,具体参照reason说明 | |
208514 | 不合规范的订单号(8-32位) | |
208515 | 校验值sign错误 | |
208516 | 重复的订单号(近60天订单周期内单号不能重复)(需要自行进行二次确认,是否进行失败处理) | |
208517 | 当前账户可用余额不足 |
系统级错误码参照:
错误码 | 说明 | 旧版本(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) | 具体错误代码 |
完整教学代码示例:
语言 | 标题 | 提供者 | 时间 | |
PHP | 话费充值接口示例代码 | 天聚人合 | 2020-12-11 17:11:38 | |
.NET | 手机话费充值接口调用示例 | 天聚人合 | 2020-12-11 13:34:26 | |
Go | 手机话费充值接口调用示例 | 天聚人合 | 2020-12-11 19:17:51 | |
JAVA | 手机话费充值-java示例 | 天聚人合 | 2020-12-11 17:21:11 | |
C# | 手机话费充值示例 | 天聚人合 | 2020-12-11 11:40:48 |
常见问题:
内容 | 详细 | |
---|---|---|
常见问题: | https://www.tianjurenhe.com/qa |
联系我们
内容 | 详细 | |
客服热线: | (0512) 6289 1011 | |
在线客服QQ: | 在线咨询 |
请求参数说明:
名称 | 必填 | 类型 | 说明 | |
---|---|---|---|---|
key | 是 | string | 在个人中心->我的数据,接口名称上方查看 |
返回参数说明:
名称 | 类型 | 说明 | |
---|---|---|---|
error_code | int | 返回码 | |
reason | string | 返回说明 | |
result | string | 返回结果集 | |
city | string | 支持城市 | |
company | string | 运营商 | |
companytype | string | 运营商ID | |
type | string | 支持类型1:全国 2:城市 | |
flows | list | 流量套餐列表 | |
id | string | 套餐ID | |
p | string | 套餐流量名称 | |
v | string | 套餐流量值 | |
inprice | string | 价格 | |
JSON返回示例:
{
"reason": "success",
"result": [
{
"city": "全国",
"company": "中国联通",
"companytype": "1",
"name": "中国联通全国流量套餐",
"type": "1",
"flows": [
{
"id": "1",
"p": "50M",
"v": "50",
"inprice": "5.70"
},
{
"id": "2",
"p": "200M",
"v": "200",
"inprice": "14.25"
},
{
"id": "34",
"p": "20M",
"v": "20",
"inprice": "2.85"
},
{
"id": "35",
"p": "100M",
"v": "100",
"inprice": "9.50"
},
{
"id": "36",
"p": "500M",
"v": "500",
"inprice": "28.50"
}
]
},
{
"city": "全国",
"company": "中国移动",
"companytype": "2",
"name": "中国移动全国流量套餐",
"type": "1",
"flows": [
{
"id": "3",
"p": "10M",
"v": "10",
"inprice": "2.25"
},
{
"id": "4",
"p": "30M",
"v": "30",
"inprice": "3.75"
},
{
"id": "5",
"p": "70M",
"v": "70",
"inprice": "7.50"
},
{
"id": "7",
"p": "500M",
"v": "500",
"inprice": "22.50"
},
{
"id": "26",
"p": "1G",
"v": "1024",
"inprice": "37.50"
},
{
"id": "27",
"p": "2048M",
"v": "2048",
"inprice": "52.50"
}
]
},
{
"city": "全国",
"company": "中国电信",
"companytype": "3",
"name": "中国电信全国流量套餐",
"type": "1",
"flows": [
{
"id": "8",
"p": "10M",
"v": "10",
"inprice": "1.80"
},
{
"id": "9",
"p": "30M",
"v": "30",
"inprice": "4.50"
},
{
"id": "10",
"p": "100M",
"v": "100",
"inprice": "9.00"
},
{
"id": "11",
"p": "200M",
"v": "200",
"inprice": "13.50"
},
{
"id": "12",
"p": "500M",
"v": "500",
"inprice": "27.00"
},
{
"id": "28",
"p": "1G",
"v": "1024",
"inprice": "45.00"
},
{
"id": "32",
"p": "50M",
"v": "50",
"inprice": "6.30"
}
]
}
],
"error_code": 0
}
请求参数说明:
名称 | 必填 | 类型 | 说明 | |
---|---|---|---|---|
phone | 是 | string | 要查询的手机号码 | |
key | 是 | string | 在个人中心->我的数据,接口名称上方查看 |
返回参数说明:
名称 | 类型 | 说明 | |
---|---|---|---|
error_code | int | 返回码 | |
reason | string | 返回说明 | |
result | string | 返回结果集 | |
city | string | 支持城市 | |
company | string | 运营商 | |
companytype | string | 运营商ID | |
type | string | 支持类型1:全国 2:城市 | |
flows | list | 流量套餐列表 | |
id | string | 套餐ID | |
p | string | 套餐流量名称 | |
v | string | 套餐流量值 | |
inprice | string | 价格 |
JSON返回示例:
{
"reason": "success",
"result": [
{
"city": "全国",
"company": "中国移动",
"companytype": "2",
"name": "中国移动全国流量套餐",
"type": "1",
"flows": [
{
"id": "3",
"p": "10M",
"v": "10",
"inprice": "2.90"
},
{
"id": "4",
"p": "30M",
"v": "30",
"inprice": "4.84"
},
{
"id": "5",
"p": "70M",
"v": "70",
"inprice": "9.50"
},
{
"id": "6",
"p": "150M",
"v": "150",
"inprice": "19.00"
},
{
"id": "7",
"p": "500M",
"v": "500",
"inprice": "29.04"
},
{
"id": "26",
"p": "1G",
"v": "1024",
"inprice": "48.40"
},
{
"id": "27",
"p": "2048M",
"v": "2048",
"inprice": "66.50"
},
{
"id": "33",
"p": "700M",
"v": "700",
"inprice": "38.72"
}
]
}
],
"error_code": 0
}
请求参数说明:
名称 | 必填 | 类型 | 说明 | |
---|---|---|---|---|
phone | 是 | string | 需要充值流量的手机号码 | |
pid | 是 | string | 流量套餐ID | |
orderid | 是 | string | 自定义订单号,8-32字母数字组合 | |
key | 是 | string | 在个人中心->我的数据,接口名称上方查看 | |
sign | 是 | string | 校验值,md5( OpenID+key+phone+pid+orderid),结果转为小写 |
返回参数说明:
名称 | 类型 | 说明 | |
---|---|---|---|
error_code | int | 返回码 | |
reason | string | 返回说明 | |
result | string | 返回结果集 | |
ordercash | string | 订单金额 | |
cardname | string | 套餐名称 | |
sporder_id | string | 天聚人合订单号 | |
orderid | string | 用户自定义订单号 | |
phone | string | 充值手机号码 |
JSON返回示例:
{
"reason": "提交充值成功",
"result": {
"ordercash": "2.10",
"cardname": "中国电信省内流量套餐10M",
"sporder_id": "143212457209780362",
"orderid": "a1122111ds1",
"phone": "18913513535"
},
"error_code": 0
}
请求参数说明:
名称 | 必填 | 类型 | 说明 | |
---|---|---|---|---|
orderid | 是 | string | 商家订单号,8-32位字母数字组合,请填写已经成功提交的订单号 | |
key | 是 | string | 在个人中心->我的数据,接口名称上方查看 |
返回参数说明:
名称 | 类型 | 说明 | |
---|---|---|---|
error_code | int | 返回码 | |
reason | string | 返回说明 | |
result | string | 返回结果集 |
JSON返回示例:
{
"reason": "查询成功",
"result": {
"uordercash": "1.860",
"sporder_id": "146944199833560022",
"game_state": "9"/*0:充值中 1:成功 9:失败*/
},
"error_code": 0
}
请求参数说明:
名称 | 必填 | 类型 | 说明 |
---|
返回参数说明:
名称 | 类型 | 说明 |
---|
服务级错误码参照(error_code):
错误码 | 说明 | |
---|---|---|
210501 | 错误的手机号码 | |
210502 | 错误的面值 | |
210503 | 检索不到符合该手机号码的流量套餐 | |
210504 | 套餐ID不符合当前手机号 | |
210505 | 余额不足 | |
210506 | 校验值sign错误 | |
210507 | 渠道暂时不可用 | |
210508 | 重复的订单号(需要自行进行二次确认,是否进行失败处理) | |
210509 | 订单生成失败 | |
210510 | 受理充值失败 | |
210511 | 订单号错误/不存在 |
系统级错误码参照:
错误码 | 说明 | 旧版本(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) | 具体错误代码 |
完整教学代码示例:
语言 | 标题 | 提供者 | 时间 | |
JAVA | 流量充值-java示例 | 天聚人合 | 2020-12-11 17:21:11 |
常见问题:
内容 | 详细 | |
---|---|---|
常见问题: | https://www.tianjurenhe.com/qa |
联系我们
内容 | 详细 | |
客服热线: | (0512) 6289 1011 | |
在线客服QQ: | 在线咨询 |
请求参数说明:
名称 | 必填 | 类型 | 说明 | |
---|---|---|---|---|
dtype | 否 | string | 返回的格式,json或xml,默认json | |
key | 是 | string | 您申请到的APPKEY |
返回参数说明:
名称 | 类型 | 说明 | |
---|---|---|---|
error_code | int | 返回码 | |
reason | string | 返回说明 | |
result | string | 返回结果集 |
JSON返回示例:
/* 示例内容有所省略,请以您取到的最新数据为准 */
/* 商品ID基本不会变,请做好长期的缓存 */
/* 如果您的需求量较大,请告诉我们您需要的卡种以便我们备货 */
/* 如需各卡的使用说明,请访问 https://www.tianjurenhe.com/codedoc/?type=gift */
{
"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
}
请求参数说明:
名称 | 必填 | 类型 | 说明 | |
---|---|---|---|---|
dtype | 否 | string | 返回的格式,json或xml,默认json | |
key | 是 | string | 您申请到的APPKEY | |
num | 是 | int | 购买数量,1-10 | |
productId | 是 | string | 商品ID,从商品列表查询 | |
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加密后的卡号,解密方法见:https://www.tianjurenhe.com/codedoc/?type=card、
https://www.tianjurenhe.com/codedoc/?type=decrypt*/
"cardPws": "YOYOYOYOCKN", /*DES加密后的卡密,解密方法见:https://www.tianjurenhe.com/codedoc/?type=card、
https://www.tianjurenhe.com/codedoc/?type=decrypt*/
"expireDate": "20251231" /*失效时间*/
}
]
},
"error_code": 0
}
请求参数说明:
名称 | 必填 | 类型 | 说明 | |
---|---|---|---|---|
dtype | 否 | string | 返回的格式,json或xml,默认json | |
key | 是 | string | 您申请到的APPKEY | |
juheOrderId | 否 | string | 天聚人合订单号 | |
userOrderId | 否 | string | 用户订单号,两个订单号提供一个即可 | |
sign | 是 | string | MD5(openId+key+orderid),orderid指的是天聚人合订单号或者用户订单号中的一个 |
返回参数说明:
名称 | 类型 | 说明 | |
---|---|---|---|
error_code | int | 返回码 | |
reason | string | 返回说明 | |
result | string | 返回结果集 |
JSON返回示例:
{
"reason": "查询成功",
"result": {
"juheOrderId": "201603120014351360130234",
"productId": "100022",
"submitTime": "2016-03-12 00:15:34",
"message": "发货成功",
"cards": [
{
"cardNo": "tV47z0fgrFuyAu1an1vi95ciamcrypted",
"cardPws": "udOpZ+ESspfRWjaEAjidliamcrypted",
"expireDate": "20181119"
}
]
},
"error_code": 0
}
请求参数说明:
名称 | 必填 | 类型 | 说明 | |
---|---|---|---|---|
dtype | 否 | string | 返回的格式,json或xml,默认json | |
key | 是 | string | 您申请到的APPKEY | |
begin | 是 | string | 开始的日期,如:2020-10-01 | |
end | 是 | string | 结束的日期,如:2020-11-01 |
返回参数说明:
名称 | 类型 | 说明 | |
---|---|---|---|
error_code | int | 返回码 | |
reason | string | 返回说明 | |
result | string | 返回结果集 |
JSON返回示例:
{
"reason": "查询成功",
"result": [
{
"juheOrderId": "201603141423227380180045",
"productId": "100058",
"submitTime": "2016-03-14 14:23:22",
"message": "抱歉:此商品暂无库存"
},
{
"juheOrderId": "201603141550086498910071",
"productId": "100022",
"submitTime": "2016-03-14 15:51:17",
"message": "发货成功"
}
],
"error_code": 0
}
请求参数说明:
名称 | 必填 | 类型 | 说明 | |
---|---|---|---|---|
dtype | 否 | string | 返回的格式,json或xml,默认json | |
key | 是 | string | 您申请到的APPKEY | |
begin | 是 | string | 开始日期,如:2020-10-01 | |
end | 是 | string | 结束日期,如:2020-11-01 |
返回参数说明:
名称 | 类型 | 说明 | |
---|---|---|---|
error_code | int | 返回码 | |
reason | string | 返回说明 | |
result | string | 返回结果集 |
JSON返回示例:
{
"reason": "查询成功",
"result": [
{
"juheOrderId": "2016033434341122540472",
"price": "1000.00",
"time": "2016-03-11 22:54:04",
"type": "0" /*0表示扣款,1表示加款*/
},
{
"juheOrderId": "201342343258",
"price": "999.00",
"time": "2016-03-11 22:55:32",
"type": "0"
},
有省略
],
"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) | 具体错误代码 |
完整教学代码示例:
语言 | 标题 | 提供者 | 时间 | |
JAVA | 通用礼品卡接口-java示例 | 天聚人合 | 2020-12-22 18:27:36 |
常见问题:
内容 | 详细 | |
---|---|---|
常见问题: | https://www.tianjurenhe.com/qa |
联系我们
内容 | 详细 | |
客服热线: | (0512) 6289 1011 | |
在线客服QQ: | 在线咨询 |
请求参数说明:
名称 | 必填 | 类型 | 说明 | |
---|---|---|---|---|
key | 是 | string | 在个人中心->我的数据,接口名称上方查看 |
返回参数说明:
名称 | 类型 | 说明 | |
---|---|---|---|
error_code | int | 返回码 | |
reason | string | 返回说明 | |
result | string | 返回结果集 |
JSON返回示例:
{
"reason": "查询成功",
"result": [
{
"proid": "50001",/*商品id*/
"name": "Q币1元直充",/*商品名称*/
"saleprice": "0.985",/*购买价格*/
"perprice": "1",/*原价*/
"unit": "元",/*商品单位*/
"maxnums": "10"/*单次最大可购买份数*/
},
{
"proid": "50002",
"name": "Q币5元直充",
"saleprice": "4.825",
"perprice": "5",
"unit": "元",
"maxnums": "10"
},
{
"proid": "50003",
"name": "Q币20元直充",
"saleprice": "19.300",
"perprice": "20",
"unit": "元",
"maxnums": "10"
},
{
"proid": "50004",
"name": "Q币30元直充",
"saleprice": "28.950",
"perprice": "30",
"unit": "元",
"maxnums": "10"
},
{
"proid": "50005",
"name": "Q币50元直充",
"saleprice": "48.250",
"perprice": "50",
"unit": "元",
"maxnums": "10"
},
{
"proid": "50006",
"name": "Q币100元直充",
"saleprice": "96.500",
"perprice": "100",
"unit": "元",
"maxnums": "10"
},
{
"proid": "50007",
"name": "QQ超级会员SVIP1个月",
"saleprice": "19.300",
"perprice": "20",
"unit": "月",
"maxnums": "12"
},
{
"proid": "50008",
"name": "QQ黄钻贵族1个月",
"saleprice": "9.650",
"perprice": "10",
"unit": "月",
"maxnums": "12"
},
{
"proid": "50009",
"name": "QQ黄钻豪华版1个月",
"saleprice": "14.475",
"perprice": "15",
"unit": "月",
"maxnums": "12"
},
{
"proid": "50010",
"name": "QQ蓝钻贵族1个月",
"saleprice": "9.650",
"perprice": "10",
"unit": "月",
"maxnums": "12"
},
{
"proid": "50011",
"name": "QQ绿钻贵族1个月",
"saleprice": "9.650",
"perprice": "10",
"unit": "月",
"maxnums": "12"
},
{
"proid": "50012",
"name": "QQ会员1个月",
"saleprice": "9.650",
"perprice": "10",
"unit": "月",
"maxnums": "12"
},
{
"proid": "50013",
"name": "CF会员1个月",
"saleprice": "29.550",
"perprice": "30",
"unit": "月",
"maxnums": "12"
},
{
"proid": "50014",
"name": "QQ蓝钻豪华版1个月",
"saleprice": "14.475",
"perprice": "15",
"unit": "月",
"maxnums": "12"
}
],
"error_code": 0
}
请求参数说明:
名称 | 必填 | 类型 | 说明 | |
---|---|---|---|---|
uorderid | 是 | string | 用户自定义单号,8-32位数字字母 | |
proid | 是 | string | 商品id,通过商品接口获取 | |
game_userid | 是 | string | 需要充值的账号,比如QQ号、手机号码、对应平台的账号 | |
nums | 否 | int | 购买份数,默认1,最大请参照商品接口返回 | |
key | 是 | string | 在个人中心->我的数据,接口名称上方查看 | |
sign | 是 | string | 校验值,md5(proid+nums+uorderid+game_userid+key+uid),其中uid为天聚人合登录帐号,“+”号表示连接字符串符号。 |
返回参数说明:
名称 | 类型 | 说明 | |
---|---|---|---|
error_code | int | 返回码 | |
reason | string | 返回说明 | |
result | string | 返回结果集 |
JSON返回示例:
{
"reason": "订单提交成功,请等待充值",
"result": {
"sporder_id": "Q160922235538133321", /*天聚人合订单号*/
"uorderid": "147455973840112", /*用户自定义单号*/
"game_userid": "123456789", /*充值帐号*/
"proid": "50002", /*商品id*/
"nums": "1", /*购买份数*/
"name": "Q币5元直充", /*商品名称*/
"uordercash": "4.825", /*消费金额*/
"game_state": "0" /*状态,0:充值中 1:充值成功 9:充值失败*/
},
"error_code": 0 /*返回码,0表示提交订单成功*/
}
请求参数说明:
名称 | 必填 | 类型 | 说明 | |
---|---|---|---|---|
orderid | 是 | string | 用户自定义单号 | |
key | 是 | string | 在个人中心->我的数据,接口名称上方查看 |
返回参数说明:
名称 | 类型 | 说明 | |
---|---|---|---|
error_code | int | 返回码 | |
reason | string | 返回说明 | |
result | string | 返回结果集 |
JSON返回示例:
{
"reason": "查询成功",
"result": {
"proid": "50002", /*商品id*/
"cardname": "Q币5元直充", /*商品名称*/
"game_userid": "12345678", /*充值帐号*/
"cardnum": "1", /*购买份数*/
"uordercash": "4.825", /*消费金额*/
"sporder_id": "Q16092223542348120421", /*天聚人合订单号*/
"uorderid": "147666597384068", /*用户自定义单号*/
"game_state": "9" /*状态,0:充值中 1:充值成功 9:充值失败*/
},
"error_code": 0 /*返回码,0表示查询成功*/
}
请求参数说明:
名称 | 必填 | 类型 | 说明 |
---|
返回参数说明:
名称 | 类型 | 说明 |
---|
服务级错误码参照(error_code):
错误码 | 说明 | |
---|---|---|
210801 | 产品ID不存在/暂不支持购买 | |
210802 | 自定义单号格式错误(8-32位字母数字) | |
210803 | 充值账号不能为空/格式不正确 | |
210804 | 校验值sign不合法 | |
210805 | 超出最大可购买份数限制 | |
210806 | 重复的订单号(需要自行进行二次确认,是否进行失败处理) | |
210807 | 创建订单失败 | |
210808 | 账户余额不足 | |
210809 | 商品暂无可用通道 | |
210810 | 充值失败,具体参考reason | |
210811 | 错误的订单号/订单号不存在 | |
210812 | 订单无效/受理失败 |
系统级错误码参照:
错误码 | 说明 | 旧版本(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) | 具体错误代码 |
完整教学代码示例:
语言 | 标题 | 提供者 | 时间 | |
JAVA | 文娱直充接口-java示例 | 天聚人合 | 2020-12-22 18:27:36 |
常见问题:
内容 | 详细 | |
---|---|---|
常见问题: | https://www.tianjurenhe.com/qa |
联系我们
内容 | 详细 | |
客服热线: | (0512) 6289 1011 | |
在线客服QQ: | 在线咨询 |