Service4Partner
灵游记充值接口
合作方ID(PartnerID):
| Sohu | 1 |
| Tom | 2 |
| Sina | 3 |
The following operations are supported. For a formal definition, please review the Service Description.
-
AddPointOnce
函数描述:充值'金点'或'赠点'
参数:
返回值:PartnerID 合作方ID PointType 货币类型(金点=1;赠点=2) PartnerUser 合作方用户名 Point 充值'金点'数量,数量限制(1--10000) OrderID 流水号,格式为yyyyMMddhhmmss_XXXXXX,X为数字或字母
合作方可自定义XXXXXX部分格式和长度,建议使用合作方充值卡号
流水号需保证唯一性,总长度50字符以内ISP 游戏区域(网通=1,电信=2) Hash 验证请求合法性的Hash值
0 成功 1 充值失败 -307 无效PartnerID -308 虚拟货币类型 -301 IP限制 -302 无效ISP -303 无效Hash -304 无效数量 -305 DB无法访问 -306 入流水表失败(OrderID重复) -309 入表失败(OrderID重复) -401 QueryGLUser failed,net error! -402 QueryGLUser failed,invalide sohu user! -403 QueryGLUser failed,user not found! -404 QueryGLUser failed,other reason!
-
GetPresentCardKey
函数描述:获取赠送道具的CardKey
参数:
返回值:PartnerID 合作方ID PartnerUser 合作方用户名 ISP 游戏区域(网通=1,电信=2) CardType 活动卡类型,目前支持150,350,1200 Hash 验证请求合法性的Hash值
CardKey随机数 成功,格式为:U8RV4-HPN9H-HCP7V-QM8L2-62KV9 -307 无效PartnerID -301 IP限制 -302 无效ISP -303 无效Hash -309 入表失败 -310 获取Key失败
-
IPCheck
函数描述:检查请求IP是否有权限使用服务
返回值:
成功返回:0,IP地址
-301,IP地址 IP限制
-307 无效PartnerID
-
QueryDaily
函数描述:根据日期查询每日的充值总数
参数:
Date 查询日期,格式为字符串yyyy-mm-dd
返回值:
成功返回:逗号分割的字符串,格式为:金点充值交易笔数,金点充值交易总数量,赠点充值交易笔数,赠点充值交易总数量
-301 IP限制
-307 无效PartnerID
-
QueryDailyList
函数描述:根据日期查询每日的充值明细
参数:
Date 查询日期,格式为字符串yyyy-mm-dd
返回值:
成功返回:包含所有记录的字符串,|分割每条记录
每条记录格式为逗号分割的字符串:PartnerID,PointType,PartnerUser,ISP,GlUser,AddPoint,OrderID,CreateAt
对应:合作方ID,虚拟货币类型,合作方帐号,游戏区域(网通=1,电信=2),对应的联众帐号,数量,流水号,充值时间
-301 IP限制
-307 无效PartnerID
-
QueryISPs
函数描述:返回可用ISP(游戏区域)列表
参数:
返回值:PartnerID 合作方ID
ISP名称,ISP代码[,ISP名称,ISP代码]
-
QueryLeftPoint
函数描述:查询用户'金点'和'赠点'的余额
参数:
PartnerID 合作方ID PartnerUser 合作方用户名 ISP 游戏区域(网通=1,电信=2)
返回值:
如果成功返回字符串: 1,金点数量,赠点数量;失败返回:错误码,0,0
返回值错误码:
1 success 2 fail 3 DBError 100 No_Data -1 网络失败 -2 返回数据错误 -307 无效PartnerID -301 IP限制 -302 无效ISP -401 QueryGLUser failed,net error! -402 QueryGLUser failed,invalide sohu user! -403 QueryGLUser failed,user not found! -404 QueryGLUser failed,other reason!
-
QueryPartnerUser
函数描述:查询Partner用户对应的联众用户,建议充值前调用该接口查询确定用户绑定关系存在
参数:
PartnerID 合作方ID PartnerUser 合作方用户名 ISP 游戏区域(网通=1,电信=2)
返回值:
如果成功返回字符串:联众用户名,联众用户数字ID ;失败返回:错误码
返回值错误码:
-307 无效PartnerID -301 IP限制 -302 无效ISP -401 QueryGLUser failed,net error! -402 QueryGLUser failed,invalide sohu user! -403 QueryGLUser failed,user not found! -404 QueryGLUser failed,other reason!
-
QueryTrans
函数描述:查询交易状态
参数:
返回值:PartnerID 合作方ID OrderID 流水号
0 成功 1 充值邀请失败 2 邀请应答失败(错误码0x74) 3 其他邀请应答失败 4 向MGBilling确认充值失败 -307 无效PartnerID -301 IP限制 -302 无效ISP -303 无效Hash -304 无效数量 -306 交易不存在 -401 QueryGLUser failed,net error! -402 QueryGLUser failed,invalide sohu user! -403 QueryGLUser failed,user not found! -404 QueryGLUser failed,other reason! -500 其他错误,充值没有成功