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


绿拓商城手机充值接口规范

接口地址:http://weifk.cn/mobile.asp

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

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

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

传入参数列表:

usr —— 您在绿拓商城的用户名
ord —— 本次交易的订单号。订单号必须由16位数字或字母组成,前3位必须是您的商户编号,后13位由商户系统自主生成,字母或数字均可,不区分大小写,不得包含标点符号或特殊字符,如下划线、小数点。订单号3个月内不得重复
mob —— 被充值手机号码
srv —— 运营商ID。可省略,运营商ID列表请联系我司业务另行索取。
typ —— 充值类型(0:话费;XXX:各种套餐,套餐代码表请联系我司业务另行索取)
amt —— 本次充值金额,单位:元
tim —— 订单提交时间。固定格式为“YYYYMMDDHHMMSS”。即年占4位,月、日、时、分、秒各占两位,位数不足的前面以“0”补足,小时数采用24小时记时法。如:“20120304133000”表示提交订单的时间为2012年3月4日下午1点30分整
clb —— 订单状态通知地址(可省略,表示不予通知,自己根据需要查询)
sal —— 是否接受优惠充值。可省略,“0”或省略表示“不接受”,“1”表示“接受”。优惠充值可获得更高的酬金,但可能存在延时到账、分批到账等细节问题
pay —— 最大接受总价,单位:缅元。如果系统当前售价超过此值,将返回“不支持该交易”。本参数可省略,表示同意按系统当前设定价格进行交易。如传入非数值,等同于省略本参数
rfs —— 拒绝渠道集。可省略,表示不限制渠道。如需拒绝多个渠道,使用“|”分隔。如当前有效渠道全部被您拒绝,将返回“渠道未签到”。在一笔交易充值失败需要补单时,可利用此功能避免订单再次分配到上次的渠道,从而达到更换渠道再试的目的。每笔交易的渠道名称,在订单查询接口中会有输出
sgn —— 交易签名。请将以上11个参数,即:您的用户名、订单号、被充值手机号码、运营商ID、充值类型、本次充值金额、订单提交时间、通知地址、是否接受优惠充值、最大接受总价、拒绝供货商集,以及您的商户密码,顺序拼接(按上述顺序,不是按字母顺序,中间不要使用任何分隔字符,空值直接忽略)后进行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 —— 系统繁忙(可直接处理为充值失败)
M —— 充值类型错误(可直接处理为充值失败)

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

调用示例:http://weifk.cn/mobile.asp?usr=myusername&ord=J000001000000001&mob=13558979637&srv=1&typ=0&amt=10&tim=20120304133000&clb=http://www.???.com/notice.asp&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币充值 | 业务查询 | 操作历史 | 接口规范 | 常见问题 | 联系我们
版权所有: 广州绿拓贸易有限公司 ©2024  营业时间: 每天早9点~晚9点,其它时间仍可充值,但如遇卡单需等到次日才能处理
公司地址: 广州市天河区东莞庄路2号1-30层  客服热线: 020-38828839  QQ: 307082114
营业执照: 914401066756690361粤公网安备 44010602009943号  粤ICP备16118566号-2