Skip to main content

One post tagged with "storekit"

View All Tags

1.2.3 - ExternalPurchaseCustomLink Types (iOS 18.1+)

· 2 min read
Hyo
Godot IAP Maintainer

This release syncs with OpenIAP v1.3.16 and adds type support for the new ExternalPurchaseCustomLink API introduced in iOS 18.1.

New Types

This release adds GDScript type definitions for Apple's new ExternalPurchaseCustomLink API, which allows developers to direct users to external purchase links with proper tracking.

New Enums:

# Notice type for showing external purchase disclosure
enum ExternalPurchaseCustomLinkNoticeTypeIOS {
BROWSER = 0, # Display notice for browser-based purchases
}

# Token type for tracking external purchases
enum ExternalPurchaseCustomLinkTokenTypeIOS {
ACQUISITION = 0, # For new customer acquisition tracking
SERVICES = 1, # For existing customer services tracking
}

New Result Types:

# Result from showing the notice sheet
class ExternalPurchaseCustomLinkNoticeResultIOS:
var continued: bool # True if user chose to continue
var error: String # Error message if presentation failed

# Result from requesting a token
class ExternalPurchaseCustomLinkTokenResultIOS:
var token: String # The external purchase token
var error: String # Error message if retrieval failed

iOS Version Corrections

  • ExternalPurchase API availability corrected to iOS 17.4+ (was incorrectly marked as 18.2+ in some cases)

Note

This is a type-only release. The native wrapper functions for ExternalPurchaseCustomLink API are not yet exposed in godot-iap. The types are available for future integration or manual native bridge calls.

OpenIAP Versions

PackageVersion
openiap-gql1.3.16
openiap-google1.3.27
openiap-apple1.3.14

For detailed changes, see the OpenIAP Release Notes.