(Android) Developers are able to specify whether you would like your app to be treated as child-directed for purposes of the Children’s Online Privacy Protection Act (COPPA)

By setting this method, you certify that this notification is accurate and you are authorized to act on behalf of the owner of the app. You understand that abuse of this setting may result in termination of your Google account.

Note: it may take some time for this designation to be fully implemented in applicable Google services.

See also

(iOS), Returns a base64 encoded string which you can send to your server and eventually to app store for verification. To learn about how to verify the purchases, read here: https://developer.apple.com/library/content/releasenotes/General/ValidateAppStoreReceipt/Chapters/ValidateRemotely.html#//apple_ref/doc/uid/TP40010573-CH104-SW1

Returns true if the ANE is initialized successfully

(iOS) This property is used for app store promotions for iOS devices 11+. You need to listen to PROMO_PURCHASE_FAILED and PROMO_PURCHASE_SUCCESS right after you initialized the ANE with Billing.init

        Billing.listener.addEventListener(BillingEvent.PROMO_PURCHASE_FAILED, onIosPromoPurchaseFailed);
        Billing.listener.addEventListener(BillingEvent.PROMO_PURCHASE_SUCCESS, onIosPromoPurchaseSuccess);
         
        function onIosPromoPurchaseFailed(e:BillingEvent):void
        {
         trace("onPromoPurchaseFailed: " + e.msg);
     }
         
        function onIosPromoPurchaseSuccess(e:BillingEvent):void
        {
         trace("onPromoPurchase status: " + e.status);
         trace("onPromoPurchase msg: " + e.msg);
          
         if (e.purchase)
         {
             trace("----------------");
             // we cannot determine the "billingType" on promo purchases!
             // It's your job to name your productId in a way so you will know this.
             trace("$data.orderId = " +                 e.purchase.orderId);
             trace("$data.productId = " +            e.purchase.productId);
             trace("$data.purchaseState = " +        e.purchase.purchaseState);
             trace("$data.purchaseTime = " +            e.purchase.purchaseTime);
             trace("$data.purchaseToken = " +        e.purchase.purchaseToken);
             trace("----------------");
         }
     }
     

(iOS) If you are targeting your app for kids, apple requires you to show a parental gate before a purchase flow starts. The default value is false but set this to true and when automatic payment flow starts, the event BillingEvent.PARENT_PERMISSION_REQUIRED will be dispatched.

When the event is dispatched, you must show some parental-gate in your app. read here for more information: https://developer.apple.com/app-store/parental-gates/

When you are sure that a parent is using the app, you should simply call the method Billing.continueThePreventedPurchaseFlow(); to continue the halted purchase flow.

See also

Returns a list of confirmed products found on iTunesConnect or GooglePlay console.

(Android), sets the public Android key for your app found in your GooglePlay console.

Set this property only if you want to verify purchases on device!

See also

Developers are able to specify whether to mark your ad requests to receive treatment for users in the European Economic Area (EEA) under the age of consent.

(Android), Acknowledge in-app purchases. Developers are required to acknowledge that they have granted entitlement for all in-app purchases for their application.

Warning! All purchases require acknowledgement. Failure to acknowledge a purchase will result in that purchase being refunded. one-time (consumable) products automatically uses the new Android 'consumeAsync' method which acts as an implicit acknowledgement. For subscriptions and permanent purchase use this method.

Please refer to https://developer.android.com/google/play/billing/billing_library_overview#acknowledge for more details.

Parameters

     function($error:String):void
     {
         //$error: would be available only if an error has occured. Otherwise the acknowledgement process has been done successfully.
     }
     

Deprecated, the ANE will clear the cache when required internally and you no longer have to worry about it. This method will be removed in future versions of the ANE.

(iOS), you can set Billing.PARENTAL_GATE = true if your app targets kids and promo purchases will be prevented from automatic continuation. This method will continue the purchase flow after it's being halted.

You normally won't need to dispose this ANE when initialized!

See also

Call this method to let users make payments. You should set a $callback function to know the result of the purchase.

Parameters

See also

     function($status:int, $purchase:Purchase, $msg:String, $wasConsumed:Boolean):void
     {
       //$status: if 1, it means that the purchase has been made successfully. 0 if otherwise.
       //$purchase: will be non-null if the purchase was successful.
       //$msg: a string representing the purchase result.
       //$wasConsumed: true if the purchase has been consumed already. This is meaningless when dealing with subscriptions
                  IMPORTANT:
             Unlike iOS which you could create consumable products inside iTunesConnect, in Android you
             can only create managed products. This means that native devs will always need to manually consume
             their products. To make your job easier and make sure the Android and iOS sides work similar to each
             other on this ANE, we are consuming the purchases on Android automatically (if you have set
             BillingType.CONSUMABLE in the doPayment method).
                  However, it is possible, that due to internet connection or any other reason, the process fails. So
             your Android consumable item will be purchased but not consumed! When this happens, you must
             forceConsume the item yourself. To know if this problem has happened, all you have to do is to
             check if the $wasConsumed param is true or not. and if it's false, call forceConsume on it.
                  This problem might happen on Android side only. on iOS, it will be fine because the product is marked
             consumable by iTunesConnect and will be consumed without ANE's help.
     }
     

(Android), Force consume a managed purchased product. Unlike iOS, you can only create managed products on the Android side but then, you can consume them using this method. On iOS, you can create consumable products in iTunesConnect and they will be consumed automatically when being purchased.

When a purchase happens successfully or when you are restoring the previous purchases, you must use the returned $purchase.purchaseToken and pass it through the forceConsume method to consume it.

Parameters

     function($result:Boolean):void
     {
         //$result: true if the product has been consumed successfully
     }
     

Call this method to get a Vector list of all products that user has purchased before. Please note that only BillingType.PERMANENT and BillingType.AUTO_RENEWAL are returned.

Parameters

See also

     function($purchases:Vector.<Purchase>):void
     {
       //$purchases: If null, it means there's been a problem in retriving the list of purchases from server.
       // if not null, but $purchases.length is 0, it means that there are no purchase records for this user on server
     }
     

Call this method to initialize the Billing ANE. If you are building for iOS only, you can pass null for Android parameters. The same thing is true if you are building for Android only.

When you initalize this ANE, you must pass the returning result function to know when the initializing job is finished. You must wait for a successful result before calling any other methods on this extension.

The initialization job checks and verifies the list of product IDs you have passed in, to make sure your product IDs are valid. Please be alerted that when you add your products on Google Play or iTunes Connect, it may take a few hours before they are propagate globally, so make sure you are waiting enough before testing your products availability

Parameters

     function($status:int, $msg:String):void
     {
         //$status: if 1, means the initialization has been successful. if 0, it means the native code was NOT initialized successfully
         //$msg: a string message describing what is possibly wrong in case $status is 0.
     }
     

(Android), check if the named featureType is supported or not.

Parameters

(Android), Initiate a flow to confirm the change of price for an item subscribed by the user.

When the price of a user subscribed item has changed, launch this flow to take users to a screen with price change information. User can confirm the new price or cancel the flow.

Parameters

     function($agreed:Boolean, $productId:String):void
     {
         //$agreed: true if user agreed with the price change
         //$productId: the productId initially passed through the priceChangeConfirmation method
     }
     

(Android), You can create promotional codes and your users can redeem those codes to get your in-app-products for free! To do that, call this method and it will open the redeem window in GooglePlay app. To learn more about how promo-codes work in Android, read here:

• https://support.google.com/googleplay/android-developer/answer/6321495?hl=en
• https://developer.android.com/google/play/billing/billing_onetime#redeem_a_promo_code

(Android), Use this method to let users downgrade/upgrade their exciting subscription. The returning callback will be similar to the one being used with the doPayment method.

Parameters

See also

(Android), like the iOS side, for security reasons you are recommended to verify the purchases using your own server. But yet, you may use this method to locally verify the purchases on device.

Before calling this method, you must have set the Android public key using the publicKey property.

Read here to learn how a purchase should be verified using your server: https://developer.android.com/google/play/billing/billing_library_overview#Verify-purchase

Parameters