Test Rewards

Play Billing Lab is a companion app that helps you test integrations with the Google Play billing system. You can use Play Billing Lab's out-of-app purchase (OOAP) preview testing to validate that your backend is properly configured to handle items acquired outside of your app, including Play Games Rewards.

With the OOAP preview feature, you can select a specific product or offer to show across out-of-app surfaces, such as your app details page in Google Play, and verify the end-to-end entitlement acquisition and fulfillment flow.

Prerequisites

Before using Play Billing Lab to test out-of-app purchase (OOAP) flows to validate your setup for Play Games Rewards, ensure that you meet the following requirements:

1. Enroll in the Play Games Rewards EAP.

2. Licensed tester status: Your test account must be registered as a licensed tester for the game. For details, see Google Play licensed tester documentation.

   Note: While any user can view the Play Billing Lab app, only licensed testers of EAP developers in the allowlist can configure and trigger OOAP overrides.

3. Account consistency across surfaces: You must sign in to Play Billing Lab and the Google Play Store using the same licensed tester account. If there is an account mismatch, the Play Store might not surface the overridden test product or offer, or complete the test purchase.

Download and install

You can download and install Play Billing Lab from Google Play:

• Google Play Store (Android): Play Billing Lab app
• Web testing track: Play Billing Lab web opt-in

Step-by-step EAP integration and testing guide

The following steps detail how to integrate and test Play Games Rewards using Play Billing Lab.

Step 1: Launch Play Billing Lab and sign in

When you open Play Billing Lab for the first time after installation:

• Tap Sign-in with Google.
• Select the Google Account registered as the licensed tester for your app.
• After signing in, you see the main Dashboard.

Step 2: Navigate to out-of-app purchases (OOAP) testing

• On the Dashboard, locate the Out-of-app purchases card.
• Tap Test to open the OOAP configuration setup screen.

Step 3: Specify app package name and product ID

On the OOAP setup screen, enter the required app identifiers:

1. Package name: The exact Android package name of your app (for example, com.example.app).
2. Product type: Use the drop-down menu to select either One-time product (in-app item) or Subscription.
3. Product ID (SKU): The product ID of the in-app product or subscription that you want to test.

Step 4: Select an eligible offer

After you enter the package name, product ID, and product type, Play Billing Lab queries the backend and displays a list of available offers for that product.

• For one-time products: Select the applicable purchase option or offer.

  

Step 5: Start the OOAP test

After selecting the offer, tap Start test. The configuration is saved and synced with Google Play backend servers.

After activation, your Dashboard displays an Active badge on the Out-of-app purchases card, showing the configured package name, product ID (SKU), and remaining duration.

• Testing window: Active OOAP test configurations remain active for 2 hours by default before expiring automatically.

• Backend override: While active, the configuration shows as the highest priority on the various OOAP surfaces (such as your app details page in the Play Store).

  

Step 6: Test end-to-end acquisition flow for out-of-app offers

While the OOAP test is active in Play Billing Lab, open the Google Play Store app signed in with the same licensed tester account:

1. Clear the Google Play Store cache:
   1. Open the Settings app on your device.
   2. Tap Apps > Google Play Store.
   3. Tap Storage and cache, and then tap Clear cache and Clear storage.
2. Open the Google Play Store app.
3. Navigate to your app details page.

4. Complete test purchase (Play Express overlay): Tap the card for the item. The native Google Play Express checkout bottom sheet overlays in the Play Store.

   • Review the price, payment instrument (test instrument for licensed testers), and offer details.
   • Tap 1-tap buy to complete the transaction.

   

5. Verify backend integration:

   • After a successful purchase, verify that Google Play sends a Real-Time Developer Notification (RTDN) to your backend server.
     • Note: Rewards also sends an RTDN.
   • Verify that your server calls the Google Play Developer API to acknowledge the purchase and grant the entitlement to the user.
   • Check the user purchase history in the Play Store app to confirm that the test order is recorded.

Step 7: Stop and clear the OOAP test

After you finish testing:

1. Go to Out-of-app purchases page.
2. Tap Clear test to stop the OOAP test and clear the OOAP test settings.

Modifying Test Configurations

You cannot change the package name, product ID, offer selection, or change the Play Store Country override while an OOAP preview test is actively running.

Doing so requires stopping and clearing the current OOAP testing

How to edit product or offer

If you are currently running an OOAP test and want to test a different product or offer:

1. Open Play Billing Lab and tap View on the active Out-of-app purchases card.
2. Tap Edit to modify the package name, product ID or testing offer.
3. Confirm Stop test when prompted. The test will be stopped and all relevant inputs will be cleared.
4. Enter your new product or select the new offer, and restart the test.

How to test localized pricing with country overrides

Play Billing Lab lets you override your Google Play Store country to test regional pricing and currency formatting. However, country changes must be synchronized cleanly with OOAP testing:

1. Stop Active OOAP Test: If you attempt to edit your country override while an OOAP test is active, either from the Dashboard or Out of app purchase page, Play Billing Lab will display a warning prompting you to stop the test first. Confirming by tapping Stop test will stop the current OOAP test and clear the test inputs.

2. Set Country Override: After stopping the OOAP test, you can edit your country setting in the Configuration Settings page. Select the target country (for example, Japan, United Kingdom) and tap Apply.

3. Restart OOAP Test: Once the country override is active, return to the Out-of-app purchases card, select your product and offer, and tap Start test.

   Your dashboard will now show both an active Country Override and an active OOAP Test.

4. Verify Localized Price in the Play Store: Open the Play Store and visit your app's details page. The surfaced UI card and Play Express bottom sheet will now display the product price formatted in the local currency of your overridden country!

Troubleshooting and frequently asked questions