Packageyy
Interfacepublic interface IFinance extends flash.events.IEventDispatcher

财务接口。提供Y币扣费请求和赠送开放平台礼物接口。



Public Methods
 MethodDefined By
  
buy(sn:String, serverId:uint, money:uint, moneyType:uint, token:String, mode:uint = 0):Object
发送扣费请求。某些参数需要从应用服务器获取。
IFinance
  
buyByYuan(sn:String, serverId:uint, money:Number, moneyType:uint, token:String, mode:uint = 0):Object
以元为单位发送扣费请求。某些参数需要从应用服务器获取。
IFinance
  
buyGifts(sn:String, serverId:uint, toUid:uint, giftId:uint, giftCount:uint, moneyType:uint, token:String, mode:uint = 0):Object
发送赠送礼物请求。某些参数需要从应用服务器获取。
IFinance
  
recharge():Object
弹出充值Y币的页面。
IFinance
Events
 Event Summary Defined By
  IFinance
   扣费的响应事件。发送扣费请求后服务器返回结果时会触发此事件。 事件信息格式说明: eventData.sn: String类型 请求流水号。 eventData.mode: uint类型 0=真实扣费,1=测试扣费。 eventData.ret: int类型 请求的结果。1=正常处理 20=等待用户确认,可能会弹窗 25=非法token 3=该应用不允许扣费 -32=该用户Y币+佣金总额不足 255=失败,原因未知 IFinance
Method Detail
buy()method
public function buy(sn:String, serverId:uint, money:uint, moneyType:uint, token:String, mode:uint = 0):Object

发送扣费请求。某些参数需要从应用服务器获取。

Parameters

sn:String — 请求流水号,从您的应用服务器获取,请参考open.yy.com上文档中心的支付流程介绍。
 
serverId:uint — 您的应用服务器的Id,您可以有多个应用服务器,请参考open.yy.com上文档中心的支付流程介绍。
 
money:uint — 扣费数量,最小单位为0.01Y币,也就是1分钱。 例如 参数100表示付费1Y币。
 
moneyType:uint — 目前10表示Y币 未来会支持其他种类货币。
 
token:String — 该次消费请求的token,从应用服务器获取,请参考open.yy.com上文档中心的支付流程介绍。
 
mode:uint (default = 0) — 调用的方式,0=真实扣费,1=测试扣费,其他值无效。测试时连接测试支付服务器。

Returns
Object — 返回调用是否成功,具体属性如下。

ret: int类型 返回码 0=发送请求成功,仅仅表示发送请求成功,不表示扣费成功,非0值参考错误代码。扣费结果请参考IYYFinance.BUY_RESPONSE事件。

buyByYuan()method 
public function buyByYuan(sn:String, serverId:uint, money:Number, moneyType:uint, token:String, mode:uint = 0):Object

以元为单位发送扣费请求。某些参数需要从应用服务器获取。

Parameters

sn:String — 请求流水号,从您的应用服务器获取,请参考open.yy.com上文档中心的支付流程介绍。
 
serverId:uint — 您的应用服务器的Id,您可以有多个应用服务器,请参考open.yy.com上文档中心的支付流程介绍。
 
money:Number — 扣费数量,最小单位为0.01Y币,只能保留两位小数。 例如 参数1.11表示付费1.11Y币。
 
moneyType:uint — 目前10表示Y币 未来会支持其他种类货币。
 
token:String — 该次消费请求的token,从应用服务器获取,请参考open.yy.com上文档中心的支付流程介绍。
 
mode:uint (default = 0) — 调用的方式,0=真实扣费,1=测试扣费,其他值无效。测试时连接测试支付服务器。

Returns
Object — 返回调用是否成功,具体属性如下。

ret: int类型 返回码 0=发送请求成功,仅仅表示发送请求成功,不表示扣费成功。非0值参考错误代码。扣费结果请参考FinanceEvent.BUY_RESPONSE事件。

buyGifts()method 
public function buyGifts(sn:String, serverId:uint, toUid:uint, giftId:uint, giftCount:uint, moneyType:uint, token:String, mode:uint = 0):Object

发送赠送礼物请求。某些参数需要从应用服务器获取。

Parameters

sn:String — 请求流水号,从您的应用服务器获取,请参考open.yy.com上文档中心的支付流程介绍。
 
serverId:uint — 您的应用服务器的Id,您可以有多个应用服务器,请参考open.yy.com上文档中心的支付流程介绍。
 
toUid:uint — toUid 礼物接受者的uid,如果自己购买则填0。
 
giftId:uint — 赠送礼物的Id。
 
giftCount:uint — 赠送礼物的数量。
 
moneyType:uint — 目前10表示Y币 未来会支持其他种类货币。
 
token:String — 该次消费请求的token,从应用服务器获取,请参考open.yy.com上的支付流程介绍。
 
mode:uint (default = 0) — 调用的方式,0=真实赠送,1=测试赠送,其他值无效。测试时连接测试支付服务器。

Returns
Object — 返回调用是否成功,具体属性如下。

ret: int类型 返回码 仅仅表示发送请求成功,不表示扣费成功,0=发送请求成功,非0值参考错误代码。扣费结果请参考IYYFinance.BUY_GIFTS_RESPONSE事件。

recharge()method 
public function recharge():Object

弹出充值Y币的页面。

Returns
Object — 返回调用是否成功,是一个Object对象,具体属性如下。

ret: int类型 返回码 0=成功,非0值失败,具体请参考错误代码。

Event Detail
BUY_GIFTS_RESPONSE Event
Event Object Type: yy.events.FinanceEvent
FinanceEvent.type property = yy.events.FinanceEvent.YY_BUY_GIFTS_RESPONSE

BUY_RESPONSE Event  
Event Object Type: yy.events.FinanceEvent
FinanceEvent.type property = yy.events.FinanceEvent.BUY_RESPONSE

扣费的响应事件。发送扣费请求后服务器返回结果时会触发此事件。

事件信息格式说明:

eventData.sn: String类型 请求流水号。

eventData.mode: uint类型 0=真实扣费,1=测试扣费。

eventData.ret: int类型 请求的结果。1=正常处理 20=等待用户确认,可能会弹窗 25=非法token 3=该应用不允许扣费 -32=该用户Y币+佣金总额不足 255=失败,原因未知