# token(for:) Requests an external purchase token of the specified type. ``` static func token(for tokenType: String) async throws -> ExternalPurchaseCustomLink.Token? ``` ## Parameters `tokenType` A string that indicates the token type. Valid string values are: `ACQUISITION`, `SERVICES`, `IN_APP`, `LINK_OUT`. ## Return Value Returns an external purchase token of the type you specify, or returns `nil` if there isn’t an active token of the specified type. This method throws an error if your app isn’t eligible to use this API. ## Discussion Use this method to request tokens when your app uses the [`ExternalPurchaseCustomLink`](/documentation/StoreKit/ExternalPurchaseCustomLink) API. The token types you request depend on the region in which your app offers external purchases: - For external purchases in the European Union (EU), request the `ACQUISITION` and `SERVICES` token types when your app launches and immediately associate the tokens with a customer account on your server. You can also call this method at any other time, such as before communicating or promoting offers. The method returns the token, of each type, until it expires. - For external purchases in Japan, request the `IN_APP` or `LINK_OUT` token types. Request an `IN_APP` token type for flows that use an alternative payment provider inside the app. Request a `LINK_OUT` token type for flows where customers can complete transactions on your website, outside of the app. For more information, see [Payment options on the App Store in Japan](https://developer.apple.com/support/payment-options-on-the-app-store-in-japan). The `IN_APP` and `LINK_OUT` token types for Japan are available starting in iOS 26.4. > Tip: Request tokens before every potential transaction to ensure you have current tokens. ### Read and report tokens Decode the token to read its contents, including its expiration date. For more information, see [Receiving and decoding external purchase tokens](/documentation/StoreKit/receiving-and-decoding-external-purchase-tokens). For a code example that shows requesting tokens, see [`ExternalPurchaseCustomLink`](/documentation/StoreKit/ExternalPurchaseCustomLink). Report tokens and all transactions associated with the tokens from your server, using the . --- Copyright © 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)