加盟热线:0825-6662151
客服QQ:307082114
系统公告注册登录商户中心酬金标准话费充值Q币充值开放平台业务查询预约存款操作历史有问必答
 话费充值 | Q币充值 | 状态通知 | 订单查询 | 余额查询 | 供货接口


晴朗空充联盟手机充值接口规范

接口地址:http://www.jbks.cn/mobile.asp

功能:实时手机充值,支持中国大陆地区的所有移动、联通及电信号码

参数传入方式:GET 或 POST 均可

字符编码:本接口输入输出均采用UTF-8编码

传入参数列表:

usr —— 您在晴朗空中充值联盟的用户名
ord —— 本次交易的订单号。订单号必须由16位数字或字母组成,前3位必须是您的商户编号,后13位由商户系统自主生成,字母或数字均可,不区分大小写,不得包含标点符号或特殊字符,如下划线、小数点。订单号3个月内不得重复
mob —— 被充值手机号码
amt —— 本次充值金额,单位:人民币元
tim —— 订单提交时间。固定格式为“YYYYMMDDHHMMSS”。即年占4位,月、日、时、分、秒各占两位,位数不足的前面以“0”补足,小时数采用24小时记时法。如:“20120304133000”表示提交订单的时间为2012年3月4日下午1点30分整
clb —— 订单状态通知地址(可省略,表示不予通知,自己根据需要查询)
cst —— 订单状态通知编码。可省略,“G”或省略表示“GB2312”,“U”表示“UTF-8”
sal —— 是否接受优惠充值。可省略,“0”或省略表示“不接受”,“1”表示“接受”。优惠充值可获得更高的酬金,但可能存在延时到账、分批到账等细节问题
pay —— 最大接受总价,单位:人民币元。如果系统当前售价超过此值,将返回“不支持该交易”。本参数可省略,表示同意按系统当前设定价格进行交易。如传入非数值,等同于省略本参数
rfs —— 拒绝渠道集。可省略,表示不限制渠道。如需拒绝多个渠道,使用“|”分隔。如当前有效渠道全部被您拒绝,将返回“渠道未签到”。在一笔交易充值失败需要补单时,可利用此功能避免订单再次分配到上次的渠道,从而达到更换渠道再试的目的。每笔交易的渠道名称,在订单查询接口中会有输出
sgn —— 交易签名。请将以上10个参数,即:您的用户名、订单号、被充值手机号码、本次充值金额、订单提交时间、通知地址、通知编码、是否接受优惠充值、最大接受总价、拒绝供货商集,以及您的商户密码,顺序拼接(按上述顺序,不是按字母顺序,中间不要使用任何分隔字符,空值直接忽略)后进行MD5(32位)加密,并将该加密结果转换为大写后作为交易签名

返回值:

请注意:相同返回代码在查单接口中的定义及正确处理方式,与在本充值接口中的完全不同,务必谨慎区分!
0 —— 订单提交成功(充值结果待查)
1 —— 传入参数不完整(可直接处理为充值失败)
2 —— 订单号格式错误(可直接处理为充值失败)
3 —— 该订单号已经存在(充值结果待查,查单时需核对提交时间、充值号码及充值金额)
4 —— 被充值号码错误(可直接处理为充值失败)
5 —— 充值金额错误(可直接处理为充值失败,充值金额必须是正整数)
6 —— 单笔交易金额过大(可直接处理为充值失败)
7 —— 该商户不存在(可直接处理为充值失败)
8 —— 商户编号错误(可直接处理为充值失败)
9 —— 接口IP冲突,发起交易的IP地址与您在控制面板中绑定的接口IP地址不符(可直接处理为充值失败)
A —— 交易签名错误(可直接处理为充值失败)
B —— 商户状态异常(可直接处理为充值失败)
C —— 商户余额不足(可直接处理为充值失败)
D —— 不支持该号码(可直接处理为充值失败)
E —— 不支持该交易(可直接处理为充值失败)
F —— 渠道未签到(可直接处理为充值失败)
G —— 该商户未启用接口充值功能(可直接处理为充值失败)
H —— 系统维护(可直接处理为充值失败)
I —— 系统内部错误(可直接处理为充值失败)
J —— 订单提交时间错误(可直接处理为充值失败)
K —— 订单超出有效期(可直接处理为充值失败,如果晴朗空充联盟接收到请求的时间,与您提交订单的时间相差超过5分钟,将产生此错误)
L —— 系统繁忙(可直接处理为充值失败)

结果返回形式:<sunny>订单号|返回值|本次接口调用前您的充值账户余额|本次接口调用后您的充值账户余额|提交时间|返回结果签名</sunny>,其中返回结果签名为:把订单号、返回值、调前余额、调后余额、提交时间及商户密码(仅当返回结果为0、8、9、A、C、E、F、G时包含商户密码,其它状态下不包含商户密码)顺序拼接后进行MD5加密并转换为大写

调用示例:http://www.jbks.cn/mobile.asp?usr=myusername&ord=J000001000000001&mob=13558979637&amt=10&tim=20120304133000&clb=http://www.kzczxt.com/notice.asp&cst=G&sal=0&pay=9.9&rfs=sunny|qinlang&sgn=TIUIUKJKKUU89TGYFDC78MKYDESDXCX7

返回结果示例:<sunny>J000001000000001|0|983.22|973.32|2011-9-24 8:17:28|XJ8MK7UKDKTXCC7KUFDIUIYDESYFR45B</sunny>



系统公告 | 充值协议 | 存款方式 | 佣金标准 | 手机缴费 | Q币充值 | 业务查询 | 操作历史 | 接口规范 | 常见问题 | 联系我们
支持移动手机充值 支持联通手机充值 支持电信手机充值 支持Q币充值 365安全防范网 中国互联网违法和不良信息举报中心 四川省互联网不良与违法信息举报中心 网站备案 网络110报警服务
版权所有: 晴朗软件有限责任公司 ©2018  营业时间: 每天早9点~晚9点,其它时间仍可充值,但如遇卡单需等到次日才能处理
公司地址: 四川省遂宁市射洪县青年路45号  客服热线: 0825-6662151  QQ: 307082114
营业执照: 510922000018264  蜀ICP备06014188号  川公网安备 51092202000050号