Skip to main content

4 posts tagged with "iOS"

iOS-specific updates

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.