<!--
{
  "availability" : [
    "iOS: 27.2.0 -",
    "iPadOS: 27.2.0 -",
    "macOS: 27.2.0 -",
    "tvOS: 27.2.0 -",
    "visionOS: 27.2.0 -",
    "watchOS: 27.2.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "StoreKit",
  "identifier" : "/documentation/StoreKit/ExternalPurchaseCustomLink/showNotice(for:)",
  "metadataVersion" : "0.1.0",
  "role" : "Type Method",
  "symbol" : {
    "kind" : "Type Method",
    "modules" : [
      "StoreKit"
    ],
    "preciseIdentifier" : "s:8StoreKit26ExternalPurchaseCustomLinkO10showNotice3forAC0H6ResultOAC0cD4TypeO_tYaKFZ"
  },
  "title" : "showNotice(for:)"
}
-->

# showNotice(for:)

Displays the system disclosure notice sheet for a custom link type and asks the customer whether to continue.

```
static func showNotice(for externalPurchaseType: ExternalPurchaseCustomLink.ExternalPurchaseType) async throws -> ExternalPurchaseCustomLink.NoticeResult
```

## Parameters

`externalPurchaseType`

An [`ExternalPurchaseCustomLink.ExternalPurchaseType`](/documentation/StoreKit/ExternalPurchaseCustomLink/ExternalPurchaseType) value you select that determines the disclosure sheet the system displays.

## Return Value

This method returns [`ExternalPurchaseCustomLink.NoticeResult.continued`](/documentation/StoreKit/ExternalPurchaseCustomLink/NoticeResult/continued) to indicate the customer chooses to continue, or [`ExternalPurchaseCustomLink.NoticeResult.cancelled`](/documentation/StoreKit/ExternalPurchaseCustomLink/NoticeResult/cancelled) to indicate the customer chooses not to continue to view external purchases. This method throws an error if your app isn’t eligible to use this API at runtime. In case of an error, this method throws a [`StoreKitError`](/documentation/StoreKit/StoreKitError).

## Discussion

Use this method in combination with a specific entitlement entitlement assigned to your app and  Information Property List key depending on the region where you want to offer external purchases, following these guidelines:

- The  <doc://com.apple.documentation/documentation/BundleResources/Entitlements/com.apple.developer.storekit.external-purchase-link> entitlement requires the <doc://com.apple.documentation/documentation/BundleResources/Information-Property-List/SKExternalPurchaseCustomLinkRegions> Information Property List key.
- The <doc://com.apple.documentation/documentation/BundleResources/Entitlements/com.apple.developer.storekit.external-purchase-link-streaming> entitlement requires the <doc://com.apple.documentation/documentation/BundleResources/Information-Property-List/SKExternalPurchaseLinkStreamingRegions> Information Property List key.
- The <doc://com.apple.documentation/documentation/BundleResources/Entitlements/com.apple.developer.storekit.custom-purchase-link.allowed-regions> entitlement is a standalone entitlement and doesn’t require any additional Information Property List key.

An app needs to call this method when a customer taps on a button or scans a QR code to begin a purchase through an alternative payment processor within an app, or to go out of the app to engage with an offer.  If [`isEligible`](/documentation/StoreKit/ExternalPurchaseCustomLink/isEligible) is `false`, this method always fails.

Select the notice type based on how your app communicates the offers if the customer chooses to continue:

- Use [`ExternalPurchaseCustomLink.ExternalPurchaseType.outOfApp(destinationURL:)`](/documentation/StoreKit/ExternalPurchaseCustomLink/ExternalPurchaseType/outOfApp(destinationURL:)) if the app goes to the background, and promotes offers in a destination outside of the app.
- Use [`ExternalPurchaseCustomLink.ExternalPurchaseType.withinApp`](/documentation/StoreKit/ExternalPurchaseCustomLink/ExternalPurchaseType/withinApp) if the app promotes offers in a web view or native experience within the app.

Continue with the offer if [`showNotice(type:)`](/documentation/StoreKit/ExternalPurchaseCustomLink/showNotice(type:)) returns [`ExternalPurchaseCustomLink.NoticeResult.continued`](/documentation/StoreKit/ExternalPurchaseCustomLink/NoticeResult/continued); otherwise, don’t continue.

> Important: This API only works in countries or regions where the <doc://com.apple.documentation/documentation/BundleResources/Entitlements/com.apple.developer.storekit.custom-purchase-link.allowed-regions> entitlement is available. See the entitlement documentation for additional information.

For example code that calls this method, see [`ExternalPurchaseCustomLink`](/documentation/StoreKit/ExternalPurchaseCustomLink).

### See also

- [`ExternalPurchaseCustomLink.NoticeResult`](/documentation/StoreKit/ExternalPurchaseCustomLink/NoticeResult)
- [`ExternalPurchaseCustomLink.ExternalPurchaseType`](/documentation/StoreKit/ExternalPurchaseCustomLink/ExternalPurchaseType)

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)