This topic describes how to test your Meta Horizon Store app subscriptions. We recommend that you test your subscriptions before launching them for your customers. You can test subscriptions using a developer account from the Developer Dashboard⁠. You can perform tests from the headset and the Meta Horizon mobile app for test user accounts.

This testing allows you to perform management actions such as renewing, expiring, and canceling subscriptions for your test users. You should continue to test subscription integration with your app. You can query subscription status information for these test subscriptions through the Get subscription status (GET) API (Unity, Native, Unreal).

Use test users to test actual subscription tiers. These tiers can be in draft or published. However, note that in the case of tiers with free trials, the tier must be published for trial offers to correctly be applied for testing purposes.

Prerequisites

In order to create test subscriptions, you need to have the following:

An App in the Developer Dashboard. For creation instructions, see Create an App Page.

A Subscription in the Developer Dashboard. For creation instructions, see Create Subscriptions.

A Test User in the Developer Dashboard with test payment method added. For creation instructions, see Create Test Users.

Set up test payment method

Test users have permission to buy in-app purchase (IAP) items in your app, including Alpha, Beta, and Release Candidate apps, without using real money. These users will work with all applications on your team and can be deleted at any time. Before you can start a new test subscription, you must set up test payment information for your test user.

You can set up test payment information in the headset or the Meta Horizon mobile app. You must be signed in as the test user to set up the test payment information. To do so, log in to the test account using the generated email and password you created and add a payment method for the user. Since this user will test the IAP and Subscription checkout flow, add the following credit card numbers to test different IAP flows.

Always succeeds - 4111 1177 1155 2927

Fails at sale - 4111 1193 1540 5122

These cards only work with test users and can only be used with your team. When entering the test credit cards, you’ll need to provide a 5-digit zip code, an expiration date that has not already passed, and 111 for the Security Code.

Note: Do not use a real credit card with test users, it will be charged as a regular transaction. Please use the test credit card numbers provided.

Creating a test subscription

Use the following procedure to create a test subscription:

Go to the Developer Dashboard⁠.

In the left-side navigation, click Monetization > Subscriptions.

Click the Manage Test User Subscriptions tab.

Click Start a new test subscription.

In the Start a Test Subscription dialog window that opens, choose your Subscription Tier, Subscription Term, and Test User.

When you’re finished, click Submit.

Once the test user has been given a test subscription, the test user will be automatically entitled to the app, even if they don’t have it yet. At this point, you can use the test user account to login to the Meta Horizon Store and download the app that you would like to test. For more information on downloading test and development builds, see Testing and Releasing Builds.

Ending your test

You have two options through the Developer Dashboard⁠ to end your test: Cancellation and Deletion.

Cancel: Canceling the test ends the current subscription. A canceled subscription eventually enters the ‘EXPIRED’ state. The same test user subscribing to the same subscription is not offered another trial, if a trial offer has been set up.

Delete: Deleting a subscription removes the subscription record even if the subscription is still active or has been canceled. It will be as if the user has never purchased this subscription before. You can delete subscriptions that are no longer needed for testing purposes. If a test subscription is deleted from an app that has a trial offer set up, subscribing to the same SKU re-triggers a trial.

Did you find this page helpful?