支付

前提条件

以下章节包含一些问题，用于确定 “无代码支付” （’No Code Payment’）的确切集成场景。

• 您是否使用SafetyNet等服务加密了您的 APK？(是-Yes /否-No)
  • Yes – 如果您使用SafetyNet等服务加密了您的APK，那么您必须集成 now.gg支付SDK.
  • No – 继续下一个问题。
• 您如何验证应用中的支付？（从下拉菜单中选择）
  • 服务器端
    • 继续支付配置。
  • 客户端
    • 如果您启用了客户端支付验证，那么您必须集成 now.gg支付SDK.
  • 不验证
    • 选择您的APK和应用内产品。

支付配置

根据前提条件章节的选择，使用以下信息进行配置：

添加应用内产品：

• 登录 nowStudio.
• 点击“所有应用”（All Apps）
  • 点击应用名称旁边的“查看详情”（View Details）。
• 点击顶部导航栏上的“支付”（Payments）。
• 点击左侧边栏中的“应用内产品”（In-App Products）。
• 选择以下任一项：
  • 批量导入（Bulk Import）
  • 添加产品（Add Product）

批量导入

使用此选项，您可以将应用内产品批量导入到nowStudio。

执行此操作：

• 点击右上角的“批量导入”（Bulk Import）按钮。
• 点击如下所示的“+”图标：
  
• 选择包含应用内产品的.csv文件
  • （您应根据提供的格式准备CSV文件。点击“下载CSV格式”（‘Download CSV Format’）链接下载 CSV 格式。）
• 启用基础货币 (‘Enable Base Currency’)（可选）
  • 如果启用基础货币选项，我们将更新CSV中未列出特定地区价格的产品。
    • 该地区的新价格将基于所选的基础价格和最新的汇率。
• 请确保为目标地区的所有产品设置基础价格。(‘Base Currency’)
• 点击“导入”（’Import’）。

添加产品

注意：nowStudio允许您为应用内产品添加翻译，以便为全球用户提供本地化体验。如果用户的语言偏好与您添加的翻译语言匹配，他们将看到已翻译的应用内购买产品。

为此，请提供以下信息：

• 产品ID
• 显示的标题
  • 此字段支持多个值（翻译）,以换行符分隔。请参考此处了解更多信息。
• 描述
  • 此字段支持多个值（翻译）,以换行符分隔。请参考此处了解更多信息。
• 图标 – 点击“选择文件”（Pick file）
  • 尺寸– 1024 x 1024px
  • 图片格式 – .JPG, .JPEG, .PNG
  • 大小上限 – 10 Mb
• 选择价格设置。
  您可以选择/创建价格模板或为您添加的产品设置自定义价格。
  • 价格模板
    • 选择已创建的价格模板，或者
    • 创建新价格模板
      • 点击管理模板
      • 创建模板后，您可以选择它。
  • 自定义价格
    • 点击设置自定义价格
    • 输入默认价格
      • 基于您输入的默认价格，所有国家的价格将按照当时的汇率计算。
      • 您也可以提供特定国家的自定义价格。
    • 点击保存。
  • 您产品的基础价格来自所选的价格模板或设置的自定义价格。
    • 您可以点击查看本地价格将列出的基础价格转换为您的货币。
    • 如有需要，您可以编辑价格模板 / 自定义价格。
• 点击保存。
  产品添加后，将显示在应用内产品部分：
  
• 您还可以通过点击上图中的“导出CSV”（Export CSV）导出添加的应用内产品。

修改应用内产品

要修改已添加的应用内产品：

• 在“应用内产品”（In-app Products）部分：
  • 点击要修改的应用内产品前的“查看详情”（View Details）。
• 进行所需更改后，点击“保存”（Save）。

删除产品

要删除已添加的应用内产品：

• 在“应用内产品”（In-app Products）部分：
  • 点击要删除的应用内产品前的“查看详情”（View Details）。
  • 点击底部角落的“删除”（Delete）。
  • 在确认窗口中点击“删除”（Delete）。
• 应用内产品将被移除。

要添加订阅：

• 登录 nowStudio。
• 点击“所有应用”（All Apps）。
  • 点击要为其创建订阅的应用前的“查看详情”（View Details）。
• 点击顶部导航栏上的“支付”（Payments）。
• 点击左侧边栏中的“订阅”（Subscriptions）。
• 点击右上角的“创建订阅”（Create Subscription）。

创建订阅

注意：nowStudio允许您为订阅添加翻译，以便您为全球用户提供本地化体验。如果用户的语言偏好与您添加的翻译语言相匹配，他们将看到翻译版本。

为此，请向我们提供：

• 产品ID
  • 产品 ID 只能包含数字、大写和小写字母、下划线和句点。
• 订阅详情
  • 名称
    • 为您的订阅提供相应的简短名称。用户将在电子邮件中看到这个信息。
    • 此字段支持由换行分隔的多个值（翻译）。更多信息请参照这里。
  • 描述
    • 对您的订阅的可选描述。
    • 此字段支持由换行分隔的多个值（翻译）。更多信息请参照这里。
  • 权益
    • 点击添加权益（Add Benefit），包括最多4个权益，以帮助用户了解他们在订阅后可以获得什么。
    • 此字段支持由换行分隔的多个值（翻译）。更多信息请参照这里。
• 计费周期
  • 从下拉列表中选择您的订阅的计费周期。
  • 受支持的计费周期包括：
    • 每月（Monthly ，默认选择）
    • 每周（Weekly）
    • 每4周（Every 4 weeks）
    • 每2个月（Every 2 months）
    • 每3个月（Every 3 months）
    • 每4个月（Every 4 months）
    • 每6个月（Every 6 months）
    • 每8个月（Every 8 months）
    • 每年（Yearly）
• 选择“价格”（Pricing）
  • 使用下拉菜单，可以：
    • 选择先前创建的价格模版，或
    • 创建一个新的价格模板，如果您还没有创建过。
      • 在创建模板后，您可以选择它。
      • 点击“编辑模板”（Edit Template），以编辑选定的价格模板。
        • 价格模板可以在您添加的多个应用程序中重复使用。
        • 要管理和配置您的价格模板，请 遵循此链接。
  • 您的产品的基准价格（Base Price）将从选定的价格模板中提取。
    • 您可以点击“查看本地价格”（View Local Price）来查看或将列出的基准价格转换为您的货币。
• 点击“保存”（Save）
  添加订阅后，它将显示在订阅区：
  

订阅状态回调API

（由开发人员提供）

本章节说明了 API 规范，以便您为我们提供 SubscriptionStatusCallback API，用于发送订阅状态的更新。

以下是相关的工作流：

• nowStudio将使用这个API发送请求数据到您的游戏后端。
• 您的游戏后端可以使用我们提供的API密钥（Webhook API Key）对请求进行认证。
• 您可以根据订阅的当前状态（定义于此处）向用户分配购买的权利。
• 在我们向您提供的回调URL发送请求数据之后，我们将等待来自您API的响应。
  • 如果我们没有收到状态代码为200且成功为真的响应，我们将在一段时间内继续重试。

 POST

Authorization: "<API-Key Here>"
 Content-type: application/json

{
     "success": true, 
     "reason": "reason_for_failure". // Optional Param. Only required if success is false. 
 }