辉煌国际开户

一、文档内容流程
二、内容简介
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