应用内购买 API

借助由 StoreKit 驱动的应用内购买，在您的 iOS WebView 应用中销售数字商品和订阅。

在某些应用中，您可以购买额外的内容或服务。这类购买称为"应用内购买"。对开发者而言，它们可以是一种颇具吸引力的收入来源；对客户而言也非常便利，因为可以直接使用现有账户和支付方式完成结算。WebViewGold 允许触发 App Store 应用内购买。如果您计划在最终产品中使用此功能，请确保拥有 WebViewGold 的扩展许可证。需要升级？在此了解如何升级。

方案 1（默认）：RevenueCat

创建您的免费 RevenueCat 账户开始使用。定价信息可在其网站上查看。然后按照其安装向导和文档设置 RevenueCat（定价详情可在其网站上查看）。之后，将您的详细信息添加到 Config.swift 中。此方案同样支持 Google Play 商店的 15% Service Fee Tier Program 和 Apple 的 Small Business Program。如果您参与了这些低费率计划，请通过 RevenueCat 的 Apple Small Business Program 或 Google 15% reduced service fee 页面告知 RevenueCat。Config.swift 中的设置如下所示：

static let kRevenueCatEnable = true //Set to true to activate RevenueCat
static let kRevenueCatShowDefaultOfferingPaywall = true //Set to true to show the default offering paywall on app launch
static let revenueCatAPIKey = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" //Your RevenueCat API Key (sign up via tinyurl.com/register-revenuecat first, then follow tinyurl.com/api-key-revenuecat how to find it)
static let revenueCatProjectID = "xxxxxxxxx" //Your RevenueCat Project ID (sign up via tinyurl.com/register-revenuecat first, then follow tinyurl.com/project-id-revenuecat how to find it)

请确保 Xcode 与 App Store Connect 中的 Bundle ID 与 RevenueCat 中配置的项目一致。使用以下方式触发购买或订阅：

revenuecat://purchase?external_id=user_123&product=sub_30_days

external_id = 用户标识符，例如客户的邮箱地址或用户 ID。product = 显示在 RevenueCat 控制台中的 ID。

您还可以直接从 Web 应用展示原生的 RevenueCat 付费墙（在 RevenueCat 控制台中配置）——需要 iOS 15 或更高版本：

revenuecat://launchPaywall?external_id=user_123&offering=CustomOfferingOne

external_id = 用户标识符，例如客户的邮箱地址或用户 ID（必填）。offering = 可选的 RevenueCat offering 标识符，用于指定要展示付费墙的 offering；省略该参数则展示默认 offering 的付费墙。

方案 2：手动（不使用 RevenueCat）

首先，将 App Store Connect 中应用内购买"Shared Secret"的详细信息插入 Config.swift 文件。要在 App Store Connect 中查找您的"Shared Secret"，需要先登录您的 App Store Connect 账户。然后，前往"Users and Access"部分，并选择"Shared Secret"选项卡。您生成的"Shared Secret"将会列出，您可以将其复制并粘贴到 WebViewGold 中 Config.swift 相应的"IAPSharedSecret"字段。

我们非常关心客户的成功，并会尽一切可能为他们提供支持：这就是我们希望在此提及 App Store Small Business Program 和 Google Play 商店 15% Service Fee Tier Program 的原因。根据这些计划，符合资格的开发者可获得 15% 的降低佣金比例，比标准的 30% 大幅降低。仅需几分钟即可填写申请表单，最多可为您节省 50% 的费用（佣金比例从 30% 降至 15%）。一旦获得批准，您将在相应商店的所有付费应用和应用内购买中享受降低后的佣金比例。要了解有关 Apple 计划的更多信息，请点击此处；有关 Google Play 计划的更多信息，请点击此处。

设置完成后，对于应用内购买产品，只需链接到如下 URL：

<a href="inapppurchase://?package=IN-APP_PURCHASE_PRODUCT_IDENTIFIER&disableadmob=true&successful_url=https://www.google.com">Buy In-App Purchase</a>

• "package" 是您想要销售的商品的产品标识符。
• "successful_url" 是购买完成后您希望应用加载的 URL。
  • 您可能希望在此页面保存一个 Cookie，以便您的 Web 应用记住已完成购买。
• 如果您想在购买该产品后禁用 AdMob 广告，请包含 "disableadmob=true"。

<a href="inappsubscription://?package=IN-APP_PURCHASE_PRODUCT_IDENTIFIER&expired_url=https://www.yahoo.com&successful_url=https://www.google.com">Start In-App Subscription</a>

• "package" 是您想要销售的订阅的产品标识符。
• "successful_url" 是购买完成后您希望应用加载的 URL。
  • 您可能希望在此页面保存一个 Cookie，以便您的 Web 应用记住已激活订阅。
• "expired_url" 是订阅不再有效时您希望应用加载的 URL。
  • 您可能希望在此页面更新/删除一个 Cookie，以便您的 Web 应用记住订阅已被停用。

<script>
// Utility function to wait for a variable to be defined
function waitForVariable(variableName, callback, timeout = 5000) {
    const startTime = Date.now();

    (function checkVariable() {
        if (window[variableName] !== undefined) {
            callback(window[variableName]);
        } else if (Date.now() - startTime < timeout) {
            setTimeout(checkVariable, 100);
        } else {
            console.error(`Timeout: ${variableName} was not set within ${timeout} ms`);
        }
    })();
}

// Example: Handling In-App Purchase/Subscription variables
waitForVariable("planID", function(planID) {
    console.log("planID:", planID);
    // Send the Product ID to your server
    sendToServer("planID", planID);
});

waitForVariable("transactionIdentifier", function(transactionIdentifier) {
    console.log("transactionIdentifier:", transactionIdentifier);
    // Send the Transaction ID to your server
    sendToServer("transactionIdentifier", transactionIdentifier);
});

waitForVariable("subreceipts", function(subreceipts) {
    console.log("subreceipts:", subreceipts);
    // Send Subscription Receipt IDs to your server
    sendToServer("subreceipts", subreceipts);
});

// Function to send data to your server for validation
function sendToServer(key, value) {
    fetch("https://example.com/api/validate", {
        method: "POST",
        headers: {
            "Content-Type": "application/json"
        },
        body: JSON.stringify({ [key]: value })
    })
    .then(response => response.json())
    .then(data => console.log(`Server Response for ${key}:`, data))
    .catch(error => console.error(`Error sending ${key}:`, error));
}
</script>

恢复购买：调用 restoreinapppurchases:// 可使您的应用重新启用先前购买的内容。当用户点击带有此 URL 方案的链接时，应用会启动一个流程来重新验证并恢复应用内购买 — 适用于应用重新安装或更换设备等场景。只需添加类似以下的链接，即可让用户恢复其购买：

<a href="restoreinapppurchases://">Restore Purchases</a>

购买历史：要在您的 Web 应用中显示用户的历史购买，请参阅应用内购买历史 API（getpurchasehistory://）。

取消订阅：调用 cancelinapppurchase:// 会将用户引导至 Apple 官方的订阅管理门户，让他们通过 Apple 的原生界面取消订阅。只需添加类似以下的链接，即可将用户引导至订阅管理页面：

<a href="cancelinapppurchase://">Cancel Subscription</a>

• 成功时（示例：美利坚合众国）：var storeLocation = 'US';
• 如果未找到国家/地区代码：var storeLocation = null;

注意：使用我们的 API 向应用用户提供付费内容确实存在一定风险，即技术熟练的用户可能会在未付款的情况下访问该内容。这可能通过多种方式发生，例如直接检索并打开 Success URL 链接、卸载应用后取消订阅产品，或使用撤回权和信用卡退单流程。然而，必须指出的是，任何数字化方案都存在一定程度的风险。虽然我们将继续致力于降低这些风险，但最终由 WebViewGold 用户/开发者在使用建议方案时接受内容遭到未授权/未付费访问的风险，因为该 API 不提供任何保证。尽管如此，对大多数用户而言，使用我们的 API 的好处通常超过风险。为确保准确的收入报告并识别潜在差异，我们建议跟踪并比较 App Store Connect 的销售数据与应用内购买产品的服务器端激活数据。