Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jewelshkjony/googleplaybilling

An in-app-billing extension to monetize your app products using google play store billing library 6.1.0.
https://github.com/jewelshkjony/googleplaybilling

aix android app-inventor billing billing-extension extension google-play google-play-billing in-app-billing in-app-purchase in-app-subscription java kodular monetize niotron play-console

Last synced: 2 days ago
JSON representation

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

Awesome Lists containing this project

README 

        
# 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](https://developer.android.com/google/play/billing/deprecation-faq).






## 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](https://github.com/jewelshkjony/GooglePlayBilling/assets/75406851/0377c963-f416-4f23-a92f-132bd11dfaac)
    


    ## 💸 User Selected Alternative Billing

      

    ![image](https://github.com/jewelshkjony/GooglePlayBilling/assets/75406851/62ab76d6-9e29-4242-b545-2f83a8a066ce)
    


    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](https://github.com/jewelshkjony/GooglePlayBilling/assets/75406851/b57402ff-2b67-4e65-9a5a-355f30ab3a39)
    


    ## 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](http://img.youtube.com/vi/F0i_6fgmpJ4/0.jpg)](https://www.youtube.com/watch?v=F0i_6fgmpJ4&list=PLczFHGJFYQrmQZMn4DZvjSbWjMqvEO3OD)

      

    * If you're facing any issues, please submit your issues here → Submit Issues
    


    Testing & Live Videos
    


    ## Test Purchasing Video

    https://user-images.githubusercontent.com/75406851/186835232-ceb0fd95-d7da-4cb9-aa93-731252f89602.mp4
    



    


    ## Live / Real Purchasing Video

    https://user-images.githubusercontent.com/75406851/188348269-0fda606a-93b7-4633-bcca-55a933393561.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

    •