# wx.getGamePaymentProductInfo(Object object)
查询商品的本地化价格信息。与国内全部展示人民币价格不同,海外需要根据不同的环境展示对应的货币及价格,开发者在商品展示前需要调用该接口获取本地价格。
详细业务流程见 出海小游戏支付开发者接入文档。
# 参数
Object object
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| env | number | 是 | 环境。0: 正式环境;1: 沙箱环境 | |
| buyQuantityList | number[] | 否 | 需要查询的游戏币档位列表 | |
| productIdList | string[] | 否 | 需要查询的游戏道具 ID 列表 | |
| success | function | 否 | 接口调用成功的回调函数 | |
| fail | function | 否 | 接口调用失败的回调函数 | |
| complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
buyQuantityList和productIdList至少传一个,可以同时指定。
# 返回值
支持 Promise 风格调用。
# success 回调参数
Object res
| 属性 | 类型 | 说明 |
|---|---|---|
| currencyCode | string | 货币类型(如 "USD"、"KRW") |
| infos | Array.<ProductInfo> | 商品价格信息列表 |
# ProductInfo 结构
| 属性 | 类型 | 说明 |
|---|---|---|
| quantity | number | 游戏币档位(按 buyQuantityList 查询时返回) |
| productId | string | 游戏道具 ID(按 productIdList 查询时返回) |
| displayPrice | string | 展示价格(含货币符号,如 "$0.99") |
| currencySymbol | string | 货币符号 |
| displayTaxPrice | string | 展示税额(如适用) |
| taxIncluded | boolean | 展示价格是否包含税额(如适用) |