1.2.3 - ExternalPurchaseCustomLink Types (iOS 18.1+)
This release syncs with OpenIAP v1.3.16 and adds type support for the new ExternalPurchaseCustomLink API introduced in iOS 18.1.
New Types
ExternalPurchaseCustomLink API Types (iOS 18.1+)
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
| Package | Version |
|---|---|
| openiap-gql | 1.3.16 |
| openiap-google | 1.3.27 |
| openiap-apple | 1.3.14 |
For detailed changes, see the OpenIAP Release Notes.
