Base Classes

Classes

ClassDescription
InAppProductA product registered in the store.
InAppStoreMain entry point for managing in-app purchases.
InAppTransactionContains information about a transaction in the external app store.
InAppPurchaseBackendCommunicates with the external store.

InAppProduct

InAppProduct encapsulates a product in the external store after it has been registered in InAppStore and confirmed to exist. It has an identifier which matches the identifier of the product in the external store, it has a price which is retrieved from the external store, and it has a product type.

The product type can be Consumable or Unlockable. Consumable products can be purchased any number of times as long as each transaction is finalized explicitly by the application. Unlockable types can only be purchased once.

InAppProduct has 5 returnable variables price, title, description identifier and productType. All return a QString except productType.

ProductType is an enum type and returns 0 if it is Consumable and 1 if Unlockable.

enum ProductType
{
   Consumable,
   Unlockable
};

Check out the derived classes AndroidInAppProduct for Android and IosInAppProduct for iOS.

InAppStore

The main entry point for managing in-app purchases. It is the base class for AndroidInAppProduct and IosInAppProduct.

InAppStore is used for managing in-app purchases in the application in a cross-platform way. Depending on the compiler, InAppStore checks what platform is available using Macros.

void InAppStore::setupBackend()
{
   #ifdef Q_OS_ANDROID
   d->backend = new AndroidInAppPurchaseBackend;
   #endif

   #ifdef Q_OS_IOS
   d->backend = new IosInAppPurchaseBackend;
   #endif

   d->backend->setStore(this);

   ...

Initializing the store

Upon going to the store page in the demo, InAppStore connects all signals to related slots in setupBackend() function. Then uses the registerProduct() function to register product ID and productType of each product registered in the external store to a QHash registeredProducts.

Registering a product is asynchronous, and will at some point yield productRegistered() signals when its found from external store.

void InAppStore::registerProduct(InAppProduct *product)
{
   d->registeredProducts[product->identifier()] = product;
   emit productRegistered(product);
}

Completing a purchase

Once the items have been successfully registered in the store, The user can purchase them by pressing on of the products on the apps store page. QML will call product.purchase() function in AndroidInAppProduct or IosInAppProduct which will open the external store's purchasing flow.

When a purchase has been completed regardless of success, the transactionRedy signal will be sent to InAppProductQmlType, to notify QML to start finalize the transaction.

Restoring purchases

In the demo unlockable purchases will be saved on the apps storage. By clearing the storage the user will lose the unlockable purchase and it cannot be purchased again, as according to the external store it is already owned.

You can use the restore purchases button in the apps store page to restore your unlockable purchases. The restore purchases button calls the restorePurchases() function and will check the external store for already owned purchases. It emits the transactionRedy() signal to finalize and restore the purchase.

InAppStore has no derived classes.

InAppTransaction

InAppTransaction contains information about a transaction in the external app store and is usually provided as a result of calling InAppProduct::purchase(). When the purchase flow has been completed by the user (confirming the purchase, for instance by entering their password), the InAppStore instance containing the product will emit a InAppStore::transactionReady() signal with data about the transaction.

The status() function provides information on if the transaction was successful or not. If it was successful, then the application should take appropriate action. When the necessary action has been performed, finalize() should be called. The finalize() function should be called regardless of the status of the transaction.

Check out the derived classes AndroidInAppTransaction for android and IosInAppTransaction for iOS.

InAppPurchaseBackend

InAppPurchaseBackend is used to create derived class for AndroidInAppPurchaseBackend and IosInAppPurchaseBackend.

© 2024 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.