This section explains how to use Samsung In-App Purchase (IAP) functionality by integrating the Samsung IAP Unity Engine Plugin methods.
To avoid compatibility issues, the plugin requires the following SDKs:
- Android SDK
- Unity 2017.3.1 or later
Your IDE system must meet Unity requirements.
To import the Samsung IAP Unity plugin into your project, in Unity click Assets -> Import Package.
Plugin Package Overview
The Samsung IAP Unity plugin comes with all the content necessary for your integration.
Plugins folder contains all Samsung IAP related scripts and libraries.
Menu Scene is the Unity scene that demonstrates all the functionality of the Samsung IAP Unity plugin.
Integrate Samsung IAP Functionality
This section explains the fundamental aspects of integrating Samsung IAP functionality into your Android app by making plugin method calls to support the offering and sale of in-app items.
Note: For details about Samsung IAP method calls, see the IAP Helper API Reference.
Samsung IAP Script
Drag-and-drop the Samsung IAP script into the GameObject of your choice.
Set IAP Operating Mode
Use the SetOperationMode() method to set Samsung IAP to one of three operating modes:
During app development and testing:
- Either test mode can be set.
- IAP_MODE_PRODUCTION mode must not be set.
Caution: If production mode is set, all requests are blocked and an error is returned.
For beta release:
- IAP_MODE_PRODUCTION mode must be set.
- All beta testers download paid beta apps for free.
- Beta testers who are not whitelisted will be financially billed for in-app items, and they can test in-app purchase functionality.
- Beta testers who are whitelisted get in-app items for free, but they cannot test purchase functionality.
For validation testing and for normal release:
- IAP_MODE_PRODUCTION mode must be set prior to submitting an app and its in-app items to validation testing.
Caution: If IAP_MODE_TEST mode is set, purchase requests for paid apps and in-app items will not result in financial billing of the user. If IAP_MODE_TEST_FAILURE is set, all requests will fail.
Query Available Samsung IAP Items
Use the GetProductDetails() method to get detailed information (for example, item ID, price, and description) about some or all of the in-app items registered to your app that are available for user purchase:
- Specify one or more unique in-app item ID values (comma delimited) to get information about the specified items.
- Specify an empty string ("") to get information about all registered items.
//Get information about three in-app items SamsungIAP.Instance.GetProductDetails("com.mygame.product1, com.mygame.product2, com.mygame.product3", OnGetProductsDetails); //Get information about all in-app items SamsungIAP.Instance.GetProductDetails("", OnProductsDetails);
After processing is complete, the OnGetProductsDetails callback is triggered, which contains information about the specified items and API call processing.
Initiate a Purchase and Payment Transaction
Use the StartPayment() method to initiate a purchase and payment transaction for a specified in-app item.
You can specify your own pass-through parameter and use it for purchase and payment verification.
SamsungIAP.Instance.StartPayment("com.mygame.product1", "pass_through_value", OnPayment);
After processing is complete, the OnPayment callback is triggered, which contains information about the purchased item, the transaction, and API call processing.
Enable a Purchased Consumable Item to be Purchased Again
Use the ConsumePurchasedItems() method and the purchase ID of a consumable in-app item to enable it to be purchased again (whether or not the user has actually used the item).
Your app receives an item's purchase ID in the OnPayment and OnGetOwnedList callbacks.
After processing is complete, the OnConsume callback is triggered, which contains information about the consumed item and API call processing.
Query Previously Purchased Items
Use the GetOwnedList() method to get information about some or all of the items the user has already purchased:
|PRODUCT_TYPE_ITEM||Returns all purchased non-consumable items, and consumable items that have not been consumed.|
|PRODUCT_TYPE_SUBSCRIPTION||Returns all purchased subscription items with active subscriptions.|
|PRODUCT_TYPE_ALL||Returns all purchased non-consumable items, consumable items that have not been consumed, and subscription items with active subscriptions.|
Note: Purchased consumable items that were previously reported as consumed are not returned. Purchased subscription items with expired subscriptions are not returned.
After processing is complete, the OnGetOwnedList callback is triggered, which contains information about the specified purchased items and API call processing.
Listen to Callback Events
Implement an IAP Listener class to receive information in all the Samsung IAP callback events.
For details about callbacks and their listeners and status codes, see Callback Listeners.
Publish Your Apps and In-app Items
Register, validate, and distribute (either in beta or normal release) your Samsung IAP integrated Android app and its in-app items in the Galaxy Store:
- Get a Seller Office commercial account.
- Log in to Seller Office.
- Register your Android app and in-app items.
- Submit your app and in-app items for validation testing.
- Manage your app distribution, app and in-app items, and your finances.