一、文档内容流程
二、内容简介
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售后
开具账户成功后我司会提供客服查单群群号供查询订单充值问题.
客服咨询 2191132846
公务咨询 2675240579
客服电话 4008-111-801
上下班时间 工作日:
9:00 - 18:00