samsung-iap.* — Samsung IAP

Overview

The Samsung IAP plugin lets you sell in-app items and subscriptions through the Samsung Galaxy Store. It is built on the Samsung In-App Purchase SDK version 6.5.2 (com.samsung.developer:iap).

Requirements

• Solar2D 2024.3709 or newer. Older Solar2D builds keep using the previous version of this plugin, which is based on Samsung IAP SDK 6.1 and does not provide store.acknowledgePurchase() or store.changeSubscriptionPlan().

• Android 6.0 (API level 23) or newer. If build.settings specifies a lower minSdkVersion, the plugin raises it to 23 while building the app.

• The Samsung IAP SDK is downloaded from Maven Central while the app is built, so an internet connection is required during Android builds.

Registration/Setup

In order to test and use In App Purchases you must setup a Samsung Seller Account, create a listing to test and deploy your app for on to the Samsung App Store. Under your Seller Profile be sure add the Samsung email(s) you plan to use to test under License Test. Also you need to upload an initial binary/apk for your app in order to create and test IAP products.

Gotchas

• After a successful purchase (or a restored purchase) you must tell Samsung IAP that the item was delivered: call store.consumePurchase() for consumable items and store.acknowledgePurchase() for non-consumable items and subscriptions. Use the purchaseId of the storeTransaction event for both calls.

• Samsung IAP processes one request at a time. Wait for the event of the current request before starting the next one.

• While Samsung IAP does not require a server, in order to verify and get receipt data you can follow the Samsung IAP Server Guide.

Syntax

local store = require( "plugin.samsung.iap" )

Properties

Functions

Events

Project Settings

To use this plugin, add an entry into the plugins table of build.settings. When added, the build server will integrate the plugin during the build phase.

settings =
{
    plugins =
    {
        ["plugin.samsung.iap"] =
        {
            publisherId = "com.solar2d"
        },
    },      
}

Support

• https://developer.samsung.com/iap
• Solar2D Forums