Payments > 参考资料 >

NowGGPaymentsSdkManager

本文档包含 NowGGPaymentsSdkManager 类及其方法的参考。

属性：
Instance – 返回类的实例。

公共方法

提供以下公共方法的参考：

InitializeIap()
OnInitSuccess()
OnInitFailed()
PurchaseProduct()
OnPurchaseFailed()
ConfirmPendingPurchase()
GetStoreType()

1. InitializeIap

此方法用提供的参数初始化now.gg支付模块。

用法

 NowGGPaymentsSdkManager.Instance.InitializeIap(PAYMENT_ID)

参数

类型	参数	描述
string	PAYMENT_ID	用于启用now.gg支付的应用特定ID。

2. OnInitSuccess

此now.gg支付模块的回调函数在成功初始化时被触发。

返回值类型 – Void.

用法

 NowGGPaymentsSdkManager.Instance.OnInitSuccess += OnInitSuccess;

3. OnInitFailed

此now.gg支付模块的回调函数在初始化失败时被触发。

用法

 NowGGPaymentsSdkManager.Instance.OnInitFailed += OnInitFailed;

参数

类型	参数	描述
string	error	返回与初始化失败关联的错误。

4. PurchaseProduct

此方法用于发起产品购买。

用法

public void PurchaseProduct(string productId, string developerPayload=null)
 {
     NowGGPaymentsSdkManager.Instance.PurchaseProduct(productId, developerPayload);
 }

参数

类型	参数	描述
string	productId	购买产品的唯一标识符。
string	developerPayload	由开发者指定的字符串，包含订单的补充信息。

5. OnPurchaseFailed

当购买失败时，此回调函数返回错误码和错误信息。

定义

public void OnPurchaseFailed(int errorCode, string errorMessage)
 {
    Debug.Log($"OnPurchaseFailed: errorCode: {errorCode} and msg: {errorMessage}");
 }

响应码

以下表格展示了类型，响应码和响应描述。

类型	参数	描述
int	0	表明操作成功
int	1	表明用户取消流程或用户点击返回按钮
int	2	表明网络问题
int	3	表明支付API的版本不支付请求的类型
int	4	表明请求的物品对于购买不可用
int	5	代表多个情况，主要有：i) 提供给API的参数无效。ii)now.gg支付服务的设置问题。iii)权限问题
int	6	表明执行中发生严重错误
int	7	表明已拥有物品，购买失败
int	8	表明还未拥有物品，故不能用于消费。
int	-1	服务当前未连接。可能的原因有：i)服务维护 ii)应用处于临时状态（transient state）
int	-2	表明在特定设备上，now.gg计费服务不支持请求的功能
int	-3	表明已发生最大超时，并且计费服务尚未响应
int	100	`INVALID_PAYMENT_ID` – 这表示支付ID无效。
int	101	`PRODUCT_NOT_FOUND_ON_STUDIO` – 这表示在nowStudio上未找到产品。
int	102	`INVALID_PURCHASE_TOKEN` – 这表示提供的购买令牌无效。
int	103	`PRODUCT_ALREADY_CONSUMED` – 这表示该产品已被消耗。
int	104	`PRODUCT_ALREADY_ACKNOWLEDGED` – 这表示该产品已被确认。
int	105	`PRODUCT_NOT_CONSUMED` – 这表示购买的产品尚未消耗。
int	106	`ACTIVE_SUBSCRIPTION_CANNOT_BE_PURCHASED_AGAIN` – 这表示无法再次购买有效订阅。
int	107	`NO_VALID_SUBSCRIPTION_FOUND` – 这表示未找到有效订阅。
int	108	`PAYMENT_FAILED` – 这表示支付失败。
int	109	`PAYMENT_CANCELLED` – 这表示支付已取消。
int	110	`PAYMENT_TIMEOUT` – 这表示支付超时。
int	1000	`INTERNAL_ERROR` – 这表示发生内部错误。

6. ConfirmPendingPurchase

此方法用于检查任何未消费的购买。

定义

public void ConfirmPendingPurchase(string purchasetoken, ProductType productType) {
    if (productType == ProductType.Consumable) {
        ConsumeProduct(purchasetoken);
    } else {
        AcknowledgePurchase(purchasetoken);
    }
 }

参数

类型	参数	描述
string	purchasetoken	成功购买后产生的购买令牌。
ProductType	productType	产品类型 – 可消耗（Consumable），不可消耗（NonConsumable），订阅（Subscription）。

7. GetStoreType

此方法返回当前用于应用内购买（IAP）的商店类型。

用法

 NowGGPaymentsSdkManager.Instance.GetStoreType();

返回值

返回表示商店类型的字符串（String）。可能的取值如下：

返回值	说明
onestore	ONE Store
amazon	Amazon Appstore
huawei	Huawei 应用市场
xiaomi	小米应用商店
samsung	三星 Galaxy 应用商店
nowgg	now.gg 商店