New Features

• External Payments Program (Android 8.3.0+, Japan Only): Support for Google Play Billing Library 8.3.0's External Payments program

  • Presents a side-by-side choice between Google Play Billing and the developer's external payment option directly in the purchase flow
  • New BillingProgramAndroid.ExternalPayments billing program type
  • New DeveloperBillingOptionParamsAndroid to configure external payment option in purchase flow
  • New DeveloperBillingLaunchModeAndroid enum for how to launch the external payment link
  • New DeveloperProvidedBillingDetailsAndroid type containing externalTransactionToken when user selects developer billing
  • New developerProvidedBillingAndroid stream for listening to developer billing selection events
  • New developerBillingOption field in RequestPurchaseAndroidProps and RequestSubscriptionAndroidProps

  // Listen for developer billing selection
  iap.developerProvidedBillingAndroid.listen((details) {
    // User selected developer billing
    // Report transaction to Google within 24 hours using details.externalTransactionToken
    print('External transaction token: ${details.externalTransactionToken}');
  });
  
  // Request purchase with external payments option
  await iap.requestPurchaseWithBuilder(
    build: (builder) {
      builder.google.skus = ['product_id'];
      builder.google.developerBillingOption = DeveloperBillingOptionParamsAndroid(
        billingProgram: BillingProgramAndroid.ExternalPayments,
        launchMode: DeveloperBillingLaunchModeAndroid.LaunchInExternalBrowserOrApp,
        linkUri: 'https://example.com/checkout',
      );
      builder.type = ProductQueryType.InApp;
    },
  );