Skip to content

An in-app-billing extension to monetize your app products using google play store billing library 7.0.0.

License

Notifications You must be signed in to change notification settings

jewelshkjony/GooglePlayBilling

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 

Repository files navigation

GooglePlayBilling - InAppBilling Extension

An in-app-billing extension to monetize your app products using google play store billing library 7.0.0.

Reminder: Starting on August 2, 2023, all new apps must use Billing Library version 5 or newer. By November 1, 2023, all updates to existing apps must use Billing Library version 5 or newer. Learn more.

Start Connection

You must use this function to starts up BillingClient setup process asynchronously.

BillingServiceConnected: Sdk is ready run any billing operation.
BillingServiceDisconnected: Sdk is disconnected from billing service.

Billing Service Error

This event will be triggered when the extension got any error while doing any billing operation.

  • function Name → It’s return the name of function which got error.
  • error → It’s return the error message as string.

    End Connection

    Closes the connection and releases all held resources such as service connections.

    Is Ready

    Checks if the client is currently connected to the service, so that requests to other methods will succeed.

    Is Subscription Supported

    If feature is not supported then return false.

    Product Type

    Show In App Messages

    If you've enabled in-app messaging, Google Play will show users messaging during grace period and account hold once per day and provide them an opportunity to fix their payment without leaving the app. We recommend that you call this API whenever the user opens the app to determine whether the message should be shown. If the user successfully recovered their subscription, you will receive purchase token. You should then use this purchase token to call the Google Play Developer API and refresh the subscription status in your app.

    The subscription status changed. For example, a subscription has been recovered from a suspend state. Developers should expect the purchase token to be returned with this response code and use the purchase token with the Google Play Developer API.

  • purchaseToken → It’s return the purchase token as string.
  • response Code → It’s return the response code as integer.

    Get Product Details

    Performs a network query the details of products available for sale in your app. Watch demo block for better understanding.

  • name → It’s return the name of product as string.
  • title → It’s return the title of product as string.
  • product Id → It’s return the given product id string.
  • productType → It’s return the type of product string.
  • description → It’s return the description of product as string.
  • price → It’s return the formatted price of product as string.
  • productDetails → It’s return the object of ProductDetails.
  • response Code → It’s return the response code as integer.
  • reason → It’s return the reason for error as string.
  • message → It’s return the details error message as string.

    Get Multiple Product Details

    Performs a network query the details of products available for sale in your app. Set productIds and productTypes as list. Watch demo block for better understanding.

  • names → It’s return the names of products as list of string.
  • titles → It’s return the titles of product as list of string.
  • productIds → It’s return the given products ids list of string.
  • productTypes → It’s return the types of products list of string.
  • descriptions → It’s return the descriptions of products as list of string.
  • prices → It’s return the formatted price of product as list of string.
  • productDetailsList → It’s return the objects of ProductDetails as list.
  • response Code → It’s return the response code as integer.
  • reason → It’s return the reason for error as string.
  • message → It’s return the details error message as string.

    Get Offer Token

    You can get productDetails from GotProductDetails event.

    Launch Billing Flow

    Initiates the billing flow for an in-app purchase or subscription. You can get productDetails from GotProductDetails event.

  • purchase → It’s return the object of Purchase. Use this purchase object to Consume or Acknowledge this purchase.
  • response Code → It’s return the response code as integer.
  • reason → It’s return the reason for error as string.
  • message → It’s return the details error message as string.

    Launch Billing Flow With

    Initiates the billing flow for an in-app purchase or subscription. You can get productDetails from GotProductDetails event.

    isOfferPersonalized: The Google Play purchase screen indicating that the price was customized for the user.

  • purchase → It’s return the object of Purchase. Use this purchase object to Consume or Acknowledge this purchase.
  • response Code → It’s return the response code as integer.
  • reason → It’s return the reason for error as string.
  • message → It’s return the details error message as string.

    Launch Bundle Billing Flow

    Initiates the billing flow for bundle of in-app purchase or subscription. You can get productDetailsList from GotMultipleProductDetails event.

  • purchase → It’s return the object of Purchase. Use this purchase object to Consume or Acknowledge this purchase.
  • response Code → It’s return the response code as integer.
  • reason → It’s return the reason for error as string.
  • message → It’s return the details error message as string.

    🔁 Launch Subscription Update Flow

    Update purchase flow for in-app subscription product to update it’s billing cycle or launch for price change. You need to set the old purchase token to update the product with new prices. You can store the old purchase token locally or into your own server for later use.

    image

    💸 User Selected Alternative Billing

    image

    This event will be triggered when South Korean user select alternative billing option during payment time.
    Method to allow users in South Korea to select an alternative billing option.
    Enables the ability for users to select an alternative billing option during the purchase flow.

    image

    Get Purchase Details

    Get purchase object from GotPurchase event.

  • orderId → It’s return the order id from the purchase as string.
  • isAcknowledge → It’s return true if the purchase is acknowledged, otherwise false.
  • isAutoRenewing → It’s return true if product is auto renewable.
  • purchaseTime → It’s return the time of purchase as long.
  • purchaseToken → It’s return the purchase token as string.
  • json → It’s return the json of the purchase object as string.

    Consume

    For consumables, this method fulfills the acknowledgement requirement and indicates that your app has granted entitlement to the user. This method also enables your app to make the one-time product available for purchase again. Get purchase object from GotPurchase event.

  • token → It’s return the purchase token as string.
  • response Code → It’s return the response code as integer.
  • reason → It’s return the reason for error as string.
  • message → It’s return the details error message as string.

    Consume With

    For consumables, this method fulfills the acknowledgement requirement and indicates that your app has granted entitlement to the user. This method also enables your app to make the one-time product available for purchase again. Use purchase token to consume the purchase. Get purchaseToken from GotPurchaseDetails event.

  • token → It’s return the purchase token as string.
  • response Code → It’s return the response code as integer.
  • reason → It’s return the reason for error as string.
  • message → It’s return the details error message as string.

    Acknowledge

    To acknowledge non-consumable purchases, use this function. Get purchase object from GotPurchase event.

  • token → It’s return the purchase token as string.
  • response Code → It’s return the response code as integer.
  • reason → It’s return the reason for error as string.
  • message → It’s return the details error message as string.

    Acknowledge With

    To acknowledge non-consumable purchases, use this function. Use purchase token to acknowledge the purchase. Get purchaseToken from GotPurchaseDetails event.

  • token → It’s return the purchase token as string.
  • response Code → It’s return the response code as integer.
  • reason → It’s return the reason for error as string.
  • message → It’s return the details error message as string.

    Query Purchases

    Fetch for a user’s subscription purchases. Returns only active subscriptions and non-consumed one-time purchases.

    Is Purchased

    Get purchasesList from QueryPurchasesSuccess event. Now you can check that product is purchased by user or not by product id. If user purchased the product then it will return true, otherwise false.

  • productIds → It’s return products ids as list of string.
  • purchasesState → It’s return purchases states as list of integer. (0 == UNSPECIFIED_STATE, 1 == PURCHASED and 2 == PENDING).
  • purchasesToken → It’s return purchases token as list of string.
  • orderIds → It’s return order ids as list of string.
  • purchasesList → It’s return the purchase object as list.
  • size → It’s return the size of list as integer.
  • response Code → It’s return the response code as integer.
  • reason → It’s return the reason for error as string.
  • message → It’s return the details error message as string.

    Get Purchase History

    Returns the most recent purchase made by the user for each product, even if that purchase is expired, canceled, or consumed.

  • quantities → It’s return quantities of purchases of product as list of integer.
  • purchaseTimes → It’s return purchase time as list of long.
  • developerPayloads → It’s return developer payloads as list of string.
  • originalJsons → It’s return json of purchase object as list of string.
  • purchaseTokens → It’s return purchases token as list of string.
  • signatures → It’s return signatures as list of string.
  • productIds → It’s return products ids as list of string.
  • size → It’s return the size of list as integer.
  • response Code → It’s return the response code as integer.
  • reason → It’s return the reason for error as string.
  • message → It’s return the details error message as string.

    Implementation Guide Video

    AdmobAds

    • If you're facing any issues, please submit your issues here → Submit Issues
    Testing & Live Videos

    Test Purchasing Video

    Pay2Me.mp4

    Live / Real Purchasing Video

    Pay2Me.-.Live.Purchasing.-.In.App.Billing.Library.5.-.Google.Play.Billing.-.Kodular.-.Niotron.-.Mit.mp4

    Purchases Statements

    Example blocks

    This is very simple example blocks for using this extension.



    Getting multiple products in single request.



    Purchasing bundle of product using GetMultipleProductDetails and LaunchMultipleBillingFlow.

    ➤ Release Notes ↷

    6.1.0

    ● Extension size increased 187 KB.

    ● Added 4 new functions and events.

    ● Added 1 new property.


    6.0.1

    ● Update Play Billing Library to be compatible with Android 14.


    6.0.0

    ● Replaced ProrationMode by ReplacementMode.

    ● Removed order ID for PENDING purchases.
    (Previously, the order ID would always be created even if the purchase was pending. Starting with version 6.0.0, an order ID will not be created for pending purchases, and for these purchases, the order ID will be populated after the purchase is moved to the PURCHASED state.)

    ● Added new network error response code.
    (A new network error response code, NETWORK_ERROR, has been added starting with PBL version 6.0.0. This code is returned when an error occurs due to a network connection issue. These network connection errors were previously reported as SERVICE_UNAVAILABLE.)

    ● Added additional logging.
    (The Play Billing Library 6 release includes additional logging, which provides insight into API usage (such as success and failure) and service connection issues. This information will be used to improve the performance of the Play Billing Library and provide better support for errors.)

    ● Extension size increased 139 KB.

    ● To migrate from V5 to V6
    (I'll charge very small amount for the MAJOR update only. MINOR updates will be totally free for all migrated users.)


    5.2.0

    ● Extension size increased 149 KB.

    ● Added method to allow users in South Korea to select an alternative billing option.


    5.1.0

    ● Extension size increased 11 KB.

    ● Added GetOfferTokens method.

    ● Added GetOfferIds method.

    ● Added GetBasePlanIds method.

    ● Added GetOfferTags method.


    5.0.0

    ● Introduced a new model for subscriptions, including new entities that enable you to create multiple offers for a single subscription product.

    ● Added isOfferPersonalized method for EU personalized pricing disclosure requirements.

    LaunchPriceChangeFlow has been deprecated and will be removed in a future release.

    ● Removed setVrPurchaseFlow, which was previously used when instantiating a purchase flow. In previous versions, this method redirected the user to complete the purchase on their Android device. Once you remove this method, users will complete the purchase through the standard purchase flow.

    More Extensions

    See more extensions

    Extension specifications:

    com.jewel.googleplaybilling.aix (567 KB)
    💰 Price: $12 USD
    ⚙️ SDK Version: 7.0.0
    🌎 Last amendment: 01 July 2024
    ⚖️ License: Terms & Conditions
    🤝 Supported builder: Kodular, Niotron, AppZard, AndroidBuilder, App Inventor and it's other distributions.

    📫 How to reach me ↓

    Discord | Telegram | WhatsApp | Facebook | Messenger | Youtube