Class IYYFinance

Extends IYYCommon.
财务接口。提供Y币扣费请求和赠送开放平台礼物接口。
Defined in: yyapi.js.

Class Summary
Constructor Attributes	Constructor Name and Description
	IYYFinance() IYYFinance 构造函数

Field Summary
Field Attributes	Field Name and Description
<static>	IYYFinance.BUY_GIFTS_RESPONSE 赠送开放平台礼物的响应事件。发送赠送礼物请求后服务器返回结果时会触发此事件。
<static>	IYYFinance.BUY_RESPONSE 扣费的响应事件。发送扣费请求后服务器返回结果时会触发此事件。

Method Summary
Method Attributes	Method Name and Description
	buy(sn, serverId, money, moneyType, token, mode) 发送扣费请求。某些参数需要从应用服务器获取。
	buyByYuan(sn, serverId, money, moneyType, token, mode) 以元为单位发送扣费请求。某些参数需要从应用服务器获取。
	buyGifts(sn, serverId, toUid, giftId, giftCount, moneyType, token, mode) 发送赠送礼物请求。某些参数需要从应用服务器获取。
	recharge() 弹出充值Y币的页面。

Methods borrowed from class IYYCommon:: addEventListener, removeEventListener

Class Detail

IYYFinance()

IYYFinance 构造函数

Field Detail

<static> IYYFinance.BUY_GIFTS_RESPONSE

赠送开放平台礼物的响应事件。发送赠送礼物请求后服务器返回结果时会触发此事件。

侦听函数格式: function(eventData){    } 
eventData.sn: String类型 请求流水号。
eventData.mode: Number类型 0=真实扣费，1=测试扣费。
eventData.ret: Number类型 请求的结果。数值代表意义为：
1=正常处理 20=等待用户确认,可能会弹窗 25=非法token 3=该应用不允许扣费 -32=该用户Y币+佣金总额不足 255=失败，原因未知

使用示例：
yy.finance.addEventListener(IYYFinance.BUY_GIFTS_RESPONSE,onBuyGiftsResponse);

function onBuyGiftsResponse(eventData)
{
    document.getElementById("txtLog").innerHTML="流水号:"+eventData.sn+" 结果:"+eventData.ret+" 模式:"+eventData.mode;
}

<static> IYYFinance.BUY_RESPONSE

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

侦听函数格式: function(eventData){    } 
eventData.sn: String类型 请求流水号。
eventData.mode: Number类型 0=真实扣费，1=测试扣费。
eventData.ret: Number类型 请求的结果。数值代表意义为：
1=正常处理 20=等待用户确认,可能会弹窗 25=非法token 3=该应用不允许扣费 -32=该用户Y币+佣金总额不足 255=失败，原因未知

使用示例：
yy.finance.addEventListener(IYYFinance.BUY_RESPONSE,onBuyResponse);

function onBuyResponse(eventData)
{
    document.getElementById("txtLog").innerHTML="流水号:"+eventData.sn+" 结果:"+eventData.ret+" 模式:"+eventData.mode;
}

Method Detail

{Object} buy(sn, serverId, money, moneyType, token, mode)

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

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

Returns:: 返回调用是否成功，具体属性如下。
ret: Number类型返回码 0=发送请求成功，仅仅表示发送请求成功，不表示扣费成功，非0值参考错误代码。是否扣费成功请参考IYYFinance.BUY_RESPONSE事件。

{Object} buyByYuan(sn, serverId, money, moneyType, token, mode)

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

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

Returns:: 返回调用是否成功，具体属性如下。
ret: Number类型返回码 0=发送请求成功，仅仅表示发送请求成功，不表示扣费成功，非0值参考错误代码。是否扣费成功请参考IYYFinance.BUY_RESPONSE事件。

{Object} buyGifts(sn, serverId, toUid, giftId, giftCount, moneyType, token, mode)

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

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

Returns:: 仅仅表示发送请求成功，不表示扣费成功，0=发送请求成功，非0值参考错误代码。是否扣费成功请参考IYYFinance.BUY_GIFTS_RESPONSE事件。

{Object} recharge()

弹出充值Y币的页面。

Returns:: 返回调用是否成功，具体属性如下。
ret: Number类型返回码 0=成功，非0值失败，具体请参考错误代码。

YY开放平台 JavaScript SDK 1.19 参考手册

Classes

Class IYYFinance