All Oculus Quest developers MUST PASS the concept review prior to gaining publishing access to the Quest Store and additional resources. Submit a concept document for review as early in your Quest application development cycle as possible. For additional information and context, please see Submitting Your App to the Oculus Quest Store.
Note: You are viewing the Native version of this topic. To view this topic for Unity development, see In-App Purchase Integration (Unity). To view this topic for Unreal development, see In-App Purchase Integration (Unreal).
In-app purchases (IAP) allow users to purchase items without leaving your app.
There are two types of items that you can offer in your game, consumable and durable.
Note: All IAP operations require the user to be connected to the Internet.
Before you begin integrating the IAP methods in your experience, you need to define the items that you will be offering for purchase. The in-app purchase list can be updated or modified at any time.
Use the Add-on page of the developer dashboard to easily define items for purchase. This dashboard enables you to set a name, the SKU that you use to reference the add-on in your code, a description, price, assets and other information that describe the add-on. See Add-ons for more information.
You can define your IAP in bulk, create a tab-separated (.tsv) file with the following format. An IAP item template with this format available for download from the IAP section of the Developer Dashboard.
|unlock_level_2||Level 2 Unlock||Purchase this item to unlock the 2nd level in the game.||USD||9.99||durable|
|100_coins||100 Coins||100 coins to spend as in-game currency.||USD||2.99||consumable|
The values for the items in the table above are:
Once you’ve created the IAP file, you can upload your IAP items by selecting Upload TSV and following the on-screen prompts. After you upload your items, you will be able to view them on the Add-Ons page.
Note: You must enter your payment information for your account before you can download the template or upload a file.
Available IAP Prices
The following are the supported IAP item price tiers:
$0.01, $0.10, $0.99, $1.49, $1.99, $2.00, $2.37, $2.49, $2.67, $2.75, $2.99, $3.34, $3.99, $4.99, $5.35, $5.99, $6.69, $6.99, $7.49, $7.99, $8.99, $9.69, $9.99, $10.49, $10.99, $11.99, $12.99, $14.99, $16.74, $16.99, $18.74, $19.99, $20.99, $22.49, $22.99, $24.99, $26.99, $27.99, $29.99, $33.49, $34.99, $36.99, $39.99, $44.99, $45.99, $48.99, $49.99, $54.99, $59.99, $69.99, $79.99 $89.99, $99.99, $159.99, $199.99
For IAP associated with downloadable content, mark your app as requiring an Internet connection.
READ_EXTERNAL_STORAGEpermission because asset files are typically stored on external storage. The following example shows the manifest entry.
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
Once you’ve defined the items that you would like to offer as purchases, you can start building them as purchasable items into your app.
The following SDK methods can be called from your client app. Detail about each function can be found in the Platform SDK Reference Content.
In-App Purchases can be a wonderful way to increase income from your game. They also increase the content, and targeted In-App Purchase releases can draw users back to your game to try out new outfits, accessories, and more.
But popular games can be targeted for instances of fraud and other abuses of your purchases. Here are suggestions to prevent abuse of purchasable in game content and fraud in your purchases. We suggest incorporating anti-fraud and anti-abuse measures into your game when you’re adding In-App Purchases.
At app startup, you can call the following method to get a list of all the assets associated with the app.
This method returns a list of available asset details. Each item in the array has the following properties:
assetFileName- the file name,
assetFileID- Asset identifier
IapStatus, which is one of the following values:
downloadStatus, which is one of the following values:
installedmeaning that user has installed the file
availablemeaning that user can download the file
in-progressmeaning the file is being downloaded or is installing for that user.
If there is a file that is available to download, meaning its status is free or entitled, and
available, you can initiate the download by calling:
To make this call, pass the ID of the item as returned by the initial
GetList call. When you make this call, you will receive an immediate
DownloadResult response with the path to the asset as a confirmation that the request was successful. You should also listen for
DownloadUpdate notifications which return info about transferred bytes, and a complete flag that notifies you when the download is complete.
To retrieve a list of IAP purchases that the user has made, use the following method. The returned list includes all durable type purchases and any consumable type purchases that have not been consumed.
To retrieve a list of durable IAP items that the user has purchased use the following method. The returned list contains non-consumable purchases and is populated from the device cache. You should always use
GetViewerPurchases first and then this method if the other call fails.
To retrieve a list of IAP items that are available to the user to purchase, by SKU, use the following method:
To launch the checkout flow for a user to complete the purchase of a specified user, use the following method:
To consume a purchased item on behalf of a user, which then marks the item as used, in-app, use the following method:
For details on challenge server-to-server APIs, see IAP Server to Server APIs.