一、文档内容流程
二、内容简介
1.1价格表
运营商 归属地 折扣
移动 全国 0.998
联通 0.996
电信 0.99
1.2自助接入文档说明
文档说明
(1)文档目标
本文档的目的是为千行平台定义一个接口规范,以帮助商户快速接入千行充值平台。
(2)编码格式
所有请求和返回都是utf-8,MD5签名则是url编码之前的原始数据,签名结果不区分大小写. 充值接口
一、话费充值请求
二. (1)话费、流量充值请求
三. (2)商户提交话费、流量请求
提交地址:http://ip:port/tel/request.ashx
参数名 名称 可否为空 说明
oid 商家订单号 不可空 商户订单号必须唯一
cid 商家编号 不可空 商户编号(请登录千行esales查询)
pr 充值面值 不可空 商品面值(请登录千行esales查询)
(*与确定产品有关,即与扣款有关,系统根据充值号码省份运营商+充值面值确定产品及扣款折扣)
nb 充值数量 不可空 充值数量
fm 充值总面额 不可空 充值总面值=面值*数量
(*代表为用户最终充值的总面值)
pn 充值号码 不可空 充值的账号
注:固话必须用-分隔区号(010-82954325)
ct 充值类型 可以空 充值类型,缺省为空(手机)
1:游戏 2:手机 3:Q币 4:固话 5:国内流量 6:省内流量
ca 运营商 固话不可空 其他可空 电信:DX 移动:YD 联通:LT
rm 快慢充类型 可以空 缺省为空(快充)
0:快充 1:次日8点到账慢充,2:24小时到账慢充,3:48小时到账慢充
ru 通知地址 不可空 通知地址根据协议2.5返回充值结果
info1 扩展字段1 可以空 下游扩展字段1,结果通知时会原值返回
info2 扩展字段2 可以空 下游扩展字段2,结果通知时会原值返回
info3 扩展字段3 可以空 下游扩展字段3,结果通知时会原值返回
tsp 时间戳 不可空 请求时间戳,格式yyyyMMDDHHmmss
sign 签名 不可空
md5(oid+cid+pr+nb+fm+pn+ru+tsp+key)
(1)返回响应
提交失败举例
返回XML举例,提交成功举例
参数说明
参数 说明
sid 千行系统订单号
ft 千行订单时间
(2)错误码说明

result

code

订单状态

说明

火红彩票 true

100

火红彩票 充值中

千行收单成功,订单正在充值

false

火红彩票 250

火红彩票 充值失败

火红彩票 必须参数为空

false

火红彩票 251

充值失败

火红彩票 签名错误

false 252 未知

该订单已存在
不能直接处理为失败;未收到回调,请在2分钟后调用订单查询获取充值结果

false

253

充值失败

火红彩票 商家不存在或未启用

false

火红彩票 254

充值失败

订单金额错误

false

火红彩票 255

火红彩票 充值失败

火红彩票 卡规则错误

false

火红彩票 256

充值失败

渠道产品未开通

false

火红彩票 259

火红彩票 充值失败

渠道订单规则未设置

火红彩票 false

火红彩票 260

充值失败

火红彩票 产品已下架维护

火红彩票 false

271

充值失败

该号码连续失败次数过多

false

火红彩票 272

充值失败

火红彩票 提交订单总金额超过限制金额

false

火红彩票 273

充值失败

IP访问受限

火红彩票 false

400

火红彩票 充值失败

火红彩票 账户格式错误,如固话没有"-"

火红彩票 false

601

充值失败

火红彩票 余额不足,扣款失败

火红彩票 false

火红彩票 999

未知 系统异常,不能直接处理
未收到回调,请在2分钟后调用订单查询获取充值状态
false 其它 未知 未知,不能直接处理失败
未收到回调,请在2分钟后调用订单查询获取充值状态
一、游戏充值请求
(1)商户提交游戏充值订单 提交地址:http://ip:port/order/request.ashx

参数名

名称

可否为空 火红彩票

说明

oid

火红彩票 商户订单号

火红彩票 不可空

商户订单号,必须唯一

cid

商户编号

不可空

商户编号(请登录千行esales查询)

pid

产品编号

不可空

游戏产品编号(请登录千行esales查询)

火红彩票 pn

火红彩票 充值号码

火红彩票 不可空

游戏帐号

火红彩票 pr

产品面值

火红彩票 不可空

产品面值(千行提供, 请登录esales查询)

火红彩票 nb

充值数量

火红彩票 不可空

充值数量

火红彩票 fm

总金额

火红彩票 不可空

总金额=产品面值*充值数量

ru

火红彩票 通知地址

火红彩票 不可空

通知地址,根据协议2.5返回充值结果

火红彩票 at

火红彩票 帐号类型

可以空

辅助参数,游戏账户类型

ct

火红彩票 计费类型

可以空

火红彩票 辅助参数,游戏充值类型

fr

火红彩票 充值区域

火红彩票 可以空

火红彩票 辅助参数,游戏区

fs

充值服务器

可以空

火红彩票 辅助参数,游戏服

fn

游戏名称

火红彩票 可以空

辅助参数,游戏名称

pv

省份编码

可以空

辅助参数,终端用户所在省份

火红彩票 uip

用户IP

火红彩票 可以空

辅助参数,终端用户ip

火红彩票 info1

火红彩票 扩展字段1

火红彩票 可以空

下游扩展字段1,结果通知时会原值返回

info2

扩展字段2

火红彩票 可以空

下游扩展字段2,结果通知时会原值返回

info3

扩展字段3

可以空

下游扩展字段3,结果通知时会原值返回

火红彩票 tsp

火红彩票 时间戳

火红彩票 不可空

请求时间戳,格式yyyyMMddHHmmss

sign

MD5签名

不可空

值:md5火红彩票(oid+cid+pid+pn+pr+nb+fm+ru+tsp+key)

(2)返回响应
提交失败举例
返回XML举例,提交成功举例
参数说明
参数 说明
sid 千行系统订单号
(4)错误码说明

result

code

订单状态

说明 火红彩票

true

100

充值中

千行收单成功,订单正在充值

火红彩票 false

250

充值失败

必须参数为空

false

火红彩票 251

充值失败

火红彩票 签名错误

false

252

火红彩票 未知

该订单已存在

      不能直接处理为失败;未收到回调,请在2分钟后调用订单查询获取充值结果

false

火红彩票 253

火红彩票 充值失败

商家不存在或未启用

火红彩票 false

火红彩票 254

充值失败

火红彩票 订单金额错误

火红彩票 false

火红彩票 255

火红彩票 充值失败

卡规则错误

火红彩票 false

256

充值失败

渠道产品未开通

false

火红彩票 259

充值失败

渠道订单规则未设置

false

火红彩票 260

火红彩票 充值失败

产品已下架维护

火红彩票 false

271

火红彩票 充值失败

该号码连续失败次数过多

false

272

充值失败

提交订单总金额超过限制金额

false

火红彩票 273

火红彩票 充值失败

IP访问受限

火红彩票 false

火红彩票 400

充值失败

账户格式错误,如固话没有"-"

火红彩票 false

601

火红彩票 充值失败

火红彩票 余额不足,扣款失败

火红彩票 false

火红彩票 999

未知

系统异常,不能直接处理失败
未收到回调,请在2分钟后调用订单查询获取充值状态

火红彩票 false

其它

火红彩票 未知

未知,不能直接处理失败
未收到回调,请在2分钟后调用订单查询获取充值状态

三、充值订单查询
(1)商户提交查询请求 提交地址 http://ip:port/order/query.ashx

参数名

名称

可否为空

说明

oid

商户订单号

不可空

商户订单号

cid

商户编号

火红彩票 不可空

商户编号(千行提供)

火红彩票 tsp

时间戳

不可空

请求时间戳,格式yyyyMMddHHmmss

火红彩票 sign

火红彩票 签名

火红彩票 不可空

值: md5(oid+cid+tsp+key)

(2)返回响应
提交失败举例
返回XML举例,提交成功举例
1.3参数说明: (错误码说明见附件)
根节点code参数值为100,则根据data节点中的ste参数值判断订单状态; 否则请根据code值判断订单状态(如为258订单不存在,3分钟后可处理为失败(注意:必须在下单10分钟查询还是返回订单不存在才能处理为失败);其它错误码说明查询接口调用失败,不能对订单状态作任何处理,需再次查询订单状态)

参数名

说明 火红彩票

result

火红彩票 该次查询状态

火红彩票 code

查询返回码

火红彩票 msg

火红彩票 查询状态消息

火红彩票 pno

商户订单号(请求参数oid原值返回)

Data节点参数说明(仅当result为true的时候才会返回data节点)

火红彩票 参数

火红彩票 说明

sid

千行系统订单号

ste

订单状态,
0 充值成功 2 充值中 3 充值失败 6 部分成功

cid

商户编号

pid

产品编号

火红彩票 oid

商户订单号

pn

充值账号

fm

充值金额

dm

火红彩票 扣款折扣

ft

充值时间

火红彩票 info1

下单下游传输,原值返回

info2

火红彩票 下单下游传输,原值返回

info3

下单下游传输,原值返回

火红彩票 error

火红彩票 充值码(不用关心)

火红彩票 msg

充值消息

proof

火红彩票 充值成功可以找运营商核实的凭证。如充值卡号或流水号(部分订单能返回,有些订单无成功凭证)

(3)错误码说明

result

code

订单状态 火红彩票

说明 火红彩票

true

100

根据data节点下面的ste参数确定

代表该次查询成功,可以根据ste状态参数判断订单状态

0

火红彩票 充值成功

火红彩票 2

火红彩票 充值中

3

充值失败

6

部分成功

火红彩票 false

258

火红彩票 订单不存在,可处理为失败

该笔订单千行未成功接收,可处理为失败
注意:必须在下单10分钟查询还是返回订单不存在才能处理为失败

注:code返回其它值,仅代表该次查询失败,并不代表订单充值失败,请务必不能将订单处理为失败
四、账户余额查询
(1)商户提交余额查询请求 提交地址 http://ip:port/money/query.ashx

参数名

名称

可否为空

说明 火红彩票

cid

火红彩票 商户编号

火红彩票 不可空

商户编号

火红彩票 tsp

时间戳

不可空

火红彩票 请求时间戳,格式yyyyMMddHHmmss

sign

火红彩票 签名

火红彩票 不可空

值: md5火红彩票(cid+tsp+key)

(2)返回响应
提交失败举例
返回XML举例,提交成功举例
参数说明

参数名

说明

火红彩票 result

该次查询状态

code

查询返回码(仅100代表查询成功)

火红彩票 msg

火红彩票 查询状态消息

money

商户渠道余额

Credit

商户在千行的信用额度

错误码说明

result

code

说明 火红彩票

true

100

查询余额成功

false

250

必须参数为空

false

251

签名错误

false

253

商家不存在或未启用

五、充值结果通知(商户提供)
(1)千行回调商户通知接口 通知地址:商户下单时提交的通知地址
注:下游商户根据参数 ste+fm 来判断订单状态,ste为1时候表示充值失败,ste为0表示充值成功或部分成功,具体根据fm和tf比较大小判断,如成功面值>=提交面值,则全部成功,成功面值提交面值,则表示部分成功;

参数名

名称

可否为空

说明

火红彩票 sid

千行系统订单号

不可空

千行订单号

火红彩票 ste

订单状态

不可空

订单状态,0:成功,1:失败

cid

火红彩票 商户ID

不可空

商户编号(千行提供)

火红彩票 pid

商品编号

火红彩票 不可空

火红彩票 商品编号

oid

商户订单号

火红彩票 不可空

商户系统订单号

火红彩票 pn

火红彩票 充值帐号

不可空

充值帐号

tf

订单金额

火红彩票 不可空

火红彩票 订单提交金额

火红彩票 fm

火红彩票 成功金额

不可空

实际成功金额

火红彩票 dm

扣款折扣

火红彩票 可以空

扣款折扣

info1

扩展字段1

可以空

火红彩票 下单下游传输,原值返回

info2

扩展字段2

可以空

火红彩票 下单下游传输,原值返回

火红彩票 Info3

扩展字段3

可以空

火红彩票 下单下游传输,原值返回

error

火红彩票 返回码

火红彩票 可以空

火红彩票 返回码(无实际意义,仅作失败原因参考)

火红彩票 msg

返回消息

可以空

返回消息(无实际意义,仅作失败原因参考)

proof

成功凭证

火红彩票 可以空

火红彩票 运营商的成功凭证,如充值卡号或流水号

sign

MD5签名

火红彩票 不可空

值:
md5(sid + ste + cid +pid+oid+pn+tf+fm+key)

(2)返回响应

参数

说明 火红彩票

success

接收成功,系统将不再重发

其他

火红彩票 接收失败(系统将重发2次)

六、附件
(1)省份编码

编码(code) 火红彩票

名称

QG

火红彩票 全国

火红彩票 BJ

火红彩票 北京

SH

火红彩票 上海

SC

四川

CQ

火红彩票 重庆

火红彩票 HIN

海南

XJ

新疆

火红彩票 ZJ

浙江

火红彩票 GD

广东

火红彩票 HUN

火红彩票 湖南

JN

吉林

火红彩票 JX

火红彩票 江西

LN

辽宁

NMG

火红彩票 内蒙古

火红彩票 NX

宁夏

QH

火红彩票 青海

SD

火红彩票 山东

火红彩票 SX1

火红彩票 陕西

SX2

火红彩票 山西

火红彩票 TJ

天津

火红彩票 XZ

火红彩票 西藏

火红彩票 YN

云南

火红彩票 HUB

火红彩票 湖北

HLJ

火红彩票 黑龙江

HEN

火红彩票 河南

HEB

河北

火红彩票 GZ

火红彩票 贵州

火红彩票 GX

广西

GS

火红彩票 甘肃

FJ

福建

AH

火红彩票 安徽

JS

江苏

1.3需提供的资料开户
接入成功后需要提供以下五证开具账户:
营业执照、银行开户许可证、组织机构代码证、电信增值业务许可证、税务许可证
联系邮箱:hezuo@100bm.cn
请在提交的邮件里留下您的联系方式,审核通过后我们会通过邮件或是电话方式给您回复。
1.4售后
开具账户成功后我司会提供客服查单群群号供查询订单充值问题.
客服咨询
公务咨询
客服电话 4008-111-801
上下班时间 工作日:
9:00 - 18:00
全球彩票|火红彩票 全球彩票-火红彩票_欢迎您 全球彩票|火红彩票 全球彩票-火红彩票 全球彩票-火红彩票_欢迎您 通博彩票新濠彩票吉利彩票