Developer Console
Sign In
Sign In
Developer Console

Quick Subscribe Use Cases

To make sure you correctly integrate your app with Quick Subscribe, verify your app performs as expected with the following use cases.

Use case matrix
Use case Conditions covered
Click a case for details App entitled App downloaded Active subscription Already signed in Back button pressed Home button pressed
Case 1 No No No No No No
Case 2 Yes Yes No No No No
Case 3 Yes Yes No No Yes No
Case 4 Yes Yes No No No Yes
Case 5 Yes Yes No Yes No No
Case 6 Yes Yes No Yes Yes No
Case 7 Yes Yes No Yes No Yes
Case 8 Yes Yes Yes Yes and No No No
Case 9 No No No No Yes No
Case 10 Yes Yes No No Yes No
Case 11 Yes Yes No Yes and No Yes Yes
Case 12 Yes Yes No No No No

Case 1

Description:

A new customer who has never purchased your app, purchases a subscription by clicking Subscribe & Get on a device or Subscribe on the retail web page. After the app opens on the device, the customer creates an account.

Result:

The customer can access the content within the app. The receipt has the status FULFILLED.

Feature or scenario tested:

  • getPurchaseUpdate() method call on app launch
  • Quick Subscribe implementation for a new customer
  • Acknowledge Receipt API or notifyFulfillment() method

Case 1: Test steps for Fire TV or Fire tablet

  1. Register a Fire TV or Fire tablet with an account that has never purchased your app.
  2. Go to the Amazon Appstore and search for your app. On the app detail page, click Subscribe & Get or select a subscription available from the Subscription Option button.
  3. The purchase screen with price details and legal information appears. Complete the purchase.
  4. If the purchase is successful, the app opens automatically. Create an account and complete the sign-up process. The receipt status should not be FULFILLED before the customer completes the sign-up flow.

Expected result: After completing sign-up, the customer should be able to see the content within the app. Receipt status should be FULFILLED.

Case 1: Test steps for retail web

  1. Register a Fire TV or Fire tablet with an account that has never purchased your app.
  2. Go to the Amazon retail website and search for your app. On the app detail page, select a subscription and click Subscribe.
  3. The purchase screen with price details and legal information appears. Complete the purchase.
  4. On the Fire device, open your app and complete the sign-up flow. The receipt status should not be FULFILLED before the customer completes the sign-up flow.

Expected result: After completing sign-up, the customer should be able to see the content within the app. Receipt status should be FULFILLED.

↑ Back to top

Case 2

Description:

An existing customer who is entitled to your app and has the app downloaded, but who isn't signed in and doesn't have an active subscription. The customer makes a purchase by clicking Subscribe & Open on the device or Subscribe on the retail web page. After the app opens on the device, the customer signs in to the app.

Result:

The customer can access the content within the app. The receipt has the status FULFILLED.

Feature or scenario tested:

  • getPurchaseUpdate() method call on app launch
  • Quick Subscribe implementation for an existing customer without an active subscription who is not signed in
  • Acknowledge Receipt API or notifyFulfillment() method

Case 2: Test steps for Fire TV or Fire tablet

  1. Register a Fire TV or Fire tablet with an account that has the app downloaded, but who isn't signed in and doesn't have an active subscription.
  2. Go to the Amazon Appstore and search for your app. On the app detail page, click Subscribe & Open or select a subscription available from the Subscription Option button.
  3. The purchase screen with price details and legal information appears. Complete the purchase.
  4. If the purchase is successful, the app opens automatically. Complete the sign-in process. The receipt status should not be FULFILLED before the customer completes the sign-in flow.

Expected result: After signing-in, the customer should be able to see the content within the app. Receipt status should be FULFILLED.

Case 2: Test steps for retail web

  1. Register a Fire TV or Fire tablet with an account that has the app downloaded, but who isn't signed in and doesn't have an active subscription.
  2. Go to the Amazon retail website and search for your app. On the app detail page, select a subscription and click Subscribe.
  3. The purchase screen with price details and legal information appears. Complete the purchase.
  4. On the Fire device, open your app and complete the sign-in flow. The receipt status should not be FULFILLED before the customer completes the sign-in flow.

Expected result: After signing-in, the customer should be able to see the content within the app. Receipt status should be FULFILLED.

↑ Back to top

Case 3

Description:

An existing customer who is entitled to your app and has the app downloaded, but who isn't signed in and doesn't have an active subscription. The customer opens the app and presses the Back button. The customer makes a purchase by clicking Subscribe & Open on the device or Subscribe on the retail web page. After the app opens on the device, the customer signs in to the app.

Result:

The customer can access the content within the app. The receipt has the status FULFILLED.

Feature or scenario tested:

  • getPurchaseUpdate() method call on app launch and on resume
  • Quick Subscribe implementation for an existing customer without an active subscription who is not signed in
  • Acknowledge Receipt API or notifyFulfillment() method
  • Back button functionality

Case 3: Test steps for Fire TV or Fire tablet

  1. Register a Fire TV or Fire tablet with an account that has the app downloaded, but who isn't signed in and doesn't have an active subscription.
  2. Open your app, then press the Back button to exit the app.
  3. Go to the Amazon Appstore and search for your app. On the app detail page, click Subscribe & Open or select a subscription available from the Subscription Option button.
  4. The purchase screen with price details and legal information appears. Complete the purchase.
  5. If the purchase is successful, the app opens automatically. Complete the sign-in process. The receipt status should not be FULFILLED before the customer completes the sign-in flow.

Expected result: After signing-in, the customer should be able to see the content within the app. Receipt status should be FULFILLED.

Case 3: Test steps for retail web

  1. Register a Fire TV or Fire tablet with an account that has the app downloaded, but who isn't signed in and doesn't have an active subscription.
  2. On the device, open your app, then press the Back button to exit the app.
  3. Go to the Amazon retail website and search for your app. On the app detail page, select a subscription and click Subscribe.
  4. The purchase screen with price details and legal information appears. Complete the purchase.
  5. On the Fire device, open your app and complete the sign-in flow. The receipt status should not be FULFILLED before the customer completes the sign-in flow.

Expected result: After signing-in, the customer should be able to see the content within the app. Receipt status should be FULFILLED.

↑ Back to top

Case 4

Description:

An existing customer who is entitled to your app and has the app downloaded, but who isn't signed in and doesn't have an active subscription. The customer opens the app and presses the Home button. The customer makes a purchase by clicking Subscribe & Open on the device or Subscribe on the retail web page. After the app opens on the device, the customer signs in to the app.

Result:

The customer can access the content within the app. The receipt has the status FULFILLED.

Feature or scenario tested:

  • getPurchaseUpdate() method call in onResume()
  • Quick Subscribe implementation for an existing customer without an active subscription who is not signed in
  • Acknowledge Receipt API or notifyFulfillment() method
  • Home button functionality

Case 4: Test steps for Fire TV or Fire tablet

  1. Register a Fire TV or Fire tablet with an account that has the app downloaded, but who isn't signed in and doesn't have an active subscription.
  2. Open your app, then press the Home button.
  3. Go to the Amazon Appstore and search for your app. On the app detail page, click Subscribe & Open or select a subscription available from the Subscription Option button.
  4. The purchase screen with price details and legal information appears. Complete the purchase.
  5. If the purchase is successful, the app opens automatically. Complete the sign-in process. The receipt status should not be FULFILLED before the customer completes the sign-in flow.

Expected result: After signing-in, the customer should be able to see the content within the app. Receipt status should be FULFILLED.

Case 4: Test steps for retail web

  1. Register a Fire TV or Fire tablet with an account that has the app downloaded, but who isn't signed in and doesn't have an active subscription.
  2. On the device, open your app, then press the Home button.
  3. Go to the Amazon retail website and search for your app. On the app detail page, select a subscription and click Subscribe.
  4. The purchase screen with price details and legal information appears. Complete the purchase.
  5. On the Fire device, open your app and complete the sign-in flow. The receipt status should not be FULFILLED before the customer completes the sign-in flow.

Expected result: After signing-in, the customer should be able to see the content within the app. Receipt status should be FULFILLED.

↑ Back to top

Case 5

Description:

An existing customer who is entitled to your app, has the app downloaded and is signed in, but doesn't have an active subscription. The customer makes a purchase by clicking Subscribe & Open on the device or Subscribe on the retail web page.

Result:

After the app opens on the device, the customer can access the content. The receipt has the status FULFILLED.

Feature or scenario tested:

  • getPurchaseUpdate() method call on app launch
  • Quick Subscribe implementation for an existing customer without an active subscription who is signed in
  • Acknowledge Receipt API or notifyFulfillment() method

Case 5: Test steps for Fire TV or Fire tablet

  1. Register a Fire TV or Fire tablet with an account that owns your app, but doesn't have an active subscription, and sign in to the app.
  2. Go to the Amazon Appstore and search for your app. On the app detail page, click Subscribe & Open or select a subscription available from the Subscription Option button.
  3. The purchase screen with price details and legal information appears. Complete the purchase.

Expected result: If the purchase is successful, the app opens automatically. The customer should be able to see the content within the app. Receipt status should be FULFILLED.

Case 5: Test steps for retail web

  1. Register a Fire TV or Fire tablet with an account that owns your app, but doesn't have an active subscription, and sign in to the app.
  2. Go to the Amazon retail website and search for your app. On the app detail page, select a subscription and click Subscribe.
  3. The purchase screen with price details and legal information appears. Complete the purchase.
  4. The receipt status should not be FULFILLED before the customer opens the app. On the Fire device, open your app.

Expected result: The customer should be able to see the content within the app. Receipt status should be FULFILLED.

↑ Back to top

Case 6

Description:

An existing customer who is entitled to your app, has the app downloaded and is signed in, but doesn't have an active subscription. The customer opens the app and presses the Back button. The customer makes a purchase by clicking Subscribe & Open on the device or Subscribe on the retail web page.

Result:

After the app opens on the device, the customer can access the content. The receipt has the status FULFILLED.

Feature or scenario tested:

  • getPurchaseUpdate() method call on app launch and on resume
  • Quick Subscribe implementation for an existing customer without an active subscription who is signed in
  • Acknowledge Receipt API or notifyFulfillment() method
  • Back button functionality

Case 6: Test steps for Fire TV or Fire tablet

  1. Register a Fire TV or Fire tablet with an account that owns your app, but doesn't have an active subscription, and sign in to the app.
  2. Open your app, then press the Back button to exit the app.
  3. Go to the Amazon Appstore and search for your app. On the app detail page, click Subscribe & Open or select a subscription available from the Subscription Option button.
  4. The purchase screen with price details and legal information appears. Complete the purchase.

Expected result: If the purchase is successful, the app opens automatically. The customer should be able to see the content within the app. Receipt status should be FULFILLED.

Case 6: Test steps for retail web

  1. Register a Fire TV or Fire tablet with an account that owns your app, but doesn't have an active subscription, and sign in to the app.
  2. Open your app, then press the Back button to exit the app.
  3. Go to the Amazon retail website and search for your app. On the app detail page, select a subscription and click Subscribe.
  4. The purchase screen with price details and legal information appears. Complete the purchase.
  5. The receipt status should not be FULFILLED before the customer opens the app. On the Fire device, open your app.

Expected result: The customer should be able to see the content within the app. Receipt status should be FULFILLED.

↑ Back to top

Case 7

Description:

An existing customer who is entitled to your app, has the app downloaded and is signed in, but doesn't have an active subscription. The customer opens the app and presses the Home button. The customer makes a purchase by clicking Subscribe & Open on the device or Subscribe on the retail web page.

Result:

After the app opens on the device, the customer can access the content. The receipt has the status FULFILLED.

Feature or scenario tested:

  • getPurchaseUpdate() method call on app launch and on resume
  • Quick Subscribe implementation for an existing customer without an active subscription who is signed in
  • Acknowledge Receipt API or notifyFulfillment() method
  • Home button functionality

Case 7: Test steps for Fire TV or Fire tablet

  1. Register a Fire TV or Fire tablet with an account that owns your app, but doesn't have an active subscription, and sign in to the app.
  2. Open your app, then press the Home button.
  3. Go to the Amazon Appstore and search for your app. On the app detail page, click Subscribe & Open or select a subscription available from the Subscription Option button.
  4. The purchase screen with price details and legal information appears. Complete the purchase.

Expected result: If the purchase is successful, the app opens automatically. The customer should be able to see the content within the app. Receipt status should be FULFILLED.

Case 7: Test steps for retail web

  1. Register a Fire TV or Fire tablet with an account that owns your app, but doesn't have an active subscription, and sign in to the app.
  2. Open your app, then press the Home button.
  3. Go to the Amazon retail website and search for your app. On the app detail page, select a subscription and click Subscribe.
  4. The purchase screen with price details and legal information appears. Complete the purchase.
  5. The receipt status should not be FULFILLED before the customer opens the app. On the Fire device, open your app.

Expected result: The customer should be able to see the content within the app. Receipt status should be FULFILLED.

↑ Back to top

Case 8

Description:

An existing customer who is entitled to your app, has the app downloaded, and has an active subscription.

Result:

On the app detail page, in the Appstore or the retail web page, the Quick Subscribe offer is not visible. The result is the same whether the customer is signed in or signed out of the app.

Feature or scenario tested:

  • Quick Subscribe implementation for an existing customer with an active subscription
  • Acknowledge Receipt API or notifyFulfillment() method
  • Avoiding double purchase

Case 8: Test steps for Fire TV or Fire tablet

  1. Register a Fire TV or Fire tablet with an account that owns your app, and has an active subscription, and sign in to the app.
  2. Go to the Amazon Appstore, search for your app and access the app detail page.

Expected result: The customer should see only an option to open the app and the Quick Subscribe offer shouldn't be visible. Repeat steps with customer signed out of the app.

Case 8: Test steps for retail web

  1. Register a Fire TV or Fire tablet with an account that owns your app, and has an active subscription, and sign in to the app.
  2. Go to the Amazon retail website and search for your app and access the app detail page.

Expected result: The customer shouldn't see the Quick Subscribe offer. Repeat steps with customer signed out of the app.

↑ Back to top

Case 9

Description:

A new customer who has never purchased a subscription. The customer makes a purchase by clicking Subscribe & Get on the device. The app automatically downloads and opens, and the customer presses the Back button to exit the app. They then reopen the app and sign up.

Result:

The purchase completes successfully. The customer can access the content within the app.

Feature or scenario tested:

  • After receipt is delivered through getPurchaseUpdates(), it persists and is fulfilled

Case 9: Test steps for Fire TV or Fire tablet

  1. Register a Fire TV or Fire tablet with an account that has never purchased your app.
  2. Go to the Amazon Appstore and search for your app. On the app detail page, click Subscribe & Get or select a subscription available from the Subscription Option button.
  3. The purchase screen with price details and legal information appears. Complete the purchase.
  4. If the purchase is successful, the app opens automatically. Press the Back button to exit the app before completing the sign-up process.
  5. Open the app, create an account, and complete the sign-up process. The receipt status should not be FULFILLED before the customer completes the sign-up flow.

Expected result: After signing-in, the customer should be able to see the content within the app. Receipt status should be FULFILLED.

Case 9: Test steps for retail web

  1. Register a Fire TV or Fire tablet with an account that has never purchased your app.
  2. Go to the Amazon retail website and search for your app. On the app detail page, select a subscription and click Subscribe.
  3. The purchase screen with price details and legal information appears. Complete the purchase.
  4. On the Fire device, open your app, then press the Back button to exit the app before completing the sign-up process.
  5. Open your app on the device again and complete the sign-up process. The receipt status should not be FULFILLED before the customer completes the sign-up flow.

Expected result: After signing-in, the customer should be able to see the content within the app. Receipt status should be FULFILLED.

↑ Back to top

Case 10

Description:

An existing customer who is entitled to your app and has the app downloaded, but who isn't signed in and doesn't have an active subscription. The customer makes a purchase by clicking Subscribe & Open on the device or Subscribe on the retail web page. After the app opens on the device, the customer presses the Back button to exit. The customer opens the app and completes the sign-in process.

Result:

The purchase completes successfully. The customer can access the content within the app.

Feature or scenario tested:

  • After receipt is delivered through getPurchaseUpdates(), it persists and is fulfilled

Case 10: Test steps for Fire TV or Fire tablet

  1. Register a Fire TV or Fire tablet with an account that has the app downloaded, but who isn't signed in and doesn't have an active subscription.
  2. Go to the Amazon Appstore and search for your app. On the app detail page, click Subscribe & Open or select a subscription available from the Subscription Option button.
  3. The purchase screen with price details and legal information appears. Complete the purchase.
  4. If the purchase is successful, the app opens automatically. Press the Back button to exit the app before completing the sign-in process.
  5. Open the app and complete the sign-in process. The receipt status should not be FULFILLED before the customer completes the sign-in flow.

Expected result: After signing-in, the customer should be able to see the content within the app. Receipt status should be FULFILLED.

Case 10: Test steps for retail web

  1. Register a Fire TV or Fire tablet with an account that has the app downloaded, but who isn't signed in and doesn't have an active subscription.
  2. Go to the Amazon retail website and search for your app. On the app detail page, select a subscription and click Subscribe.
  3. The purchase screen with price details and legal information appears. Complete the purchase.
  4. On the Fire device, open your app, then press the Back button to exit the app before completing the sign-in process.
  5. Open your app on the device again and complete the sign-in process. The receipt status should not be FULFILLED before the customer completes the sign-in flow.

Expected result: After signing-in, the customer should be able to see the content within the app. Receipt status should be FULFILLED.

↑ Back to top

Case 11

Description:

An existing customer who is entitled to your app, has the app downloaded, but doesn't have an active subscription. The customer opens the app and exits with the Back or Home button. The customer makes a purchase by clicking Subscribe & Open on the device or Subscribe on the retail web page. The app opens, and the customer completes the sign-in process.

Result:

The purchase completes successfully. The customer can access the content within the app. The result is the same whether the customer is signed in or signed out of the app, and whether the Home or Back button is pressed.

Feature or scenario tested:

  • The latest receipt is delivered to the app, rather than the last getPurchaseUpdates() response from the internal app cache.

Case 11: Test steps for Fire TV or Fire tablet

  1. Register a Fire TV or Fire tablet with an account that owns your app, has it downloaded and doesn't have an active subscription, and sign in to the app.
  2. Open your app, then press the Back or Home button.
  3. Go to the Amazon Appstore and search for your app. On the app detail page, click Subscribe & Open or select a subscription available from the Subscription Option button.
  4. The purchase screen with price details and legal information appears. Complete the purchase.

Expected result: If the purchase is successful, the app opens automatically and the customer should be able to see the content within the app. Receipt status should be FULFILLED. Repeat with the customer signed out of the app. With the customer signed out of the app, the receipt status should not be FULFILLED before the customer completes the sign-in flow.

Case 11: Test steps for retail web

  1. Register a Fire TV or Fire tablet with an account that owns your app, has it downloaded and doesn't have an active subscription, and sign in to the app.
  2. Open your app, then press the Back or Home button.
  3. Go to the Amazon retail website and search for your app. On the app detail page, select a subscription and click Subscribe.
  4. The purchase screen with price details and legal information appears. Complete the purchase.
  5. On the Fire device, open your app.

Expected result: The customer should be able to see the content within the app. Receipt status should be FULFILLED. Repeat with the customer signed out of the app. With the customer signed out of the app, the receipt status should not be FULFILLED before the customer completes the sign-in flow.

↑ Back to top

Case 12

Description:

An existing customer who is entitled to your app and has the app downloaded, but who isn't signed in and doesn't have an active subscription. The customer opens the app, exits, and restarts the device. The customer makes a purchase by clicking Subscribe & Open on the device or Subscribe on the retail web page. After the app opens on the device, the customer signs in to the app.

Result:

The customer can access the content within the app. The receipt has the status FULFILLED.

Feature or scenario tested:

  • After receipt is delivered through getPurchaseUpdates(), it persists and is fulfilled

Case 12: Test steps for Fire TV or Fire tablet

  1. Register a Fire TV or Fire tablet with an account that has the app downloaded, but who isn't signed in and doesn't have an active subscription.
  2. Open the app on the device, then exit the app and restart the device.
  3. After the device restarts, go to the Amazon Appstore and search for your app. On the app detail page, click Subscribe & Open or select a subscription available from the Subscription Option button.
  4. The purchase screen with price details and legal information appears. Complete the purchase.
  5. If the purchase is successful, the app opens automatically. Complete the sign-in process. The receipt status should not be FULFILLED before the customer completes the sign-in flow.

Expected result: After signing-in, the customer should be able to see the content within the app. Receipt status should be FULFILLED.

Case 12: Test steps for retail web

  1. Register a Fire TV or Fire tablet with an account that has the app downloaded, but who isn't signed in and doesn't have an active subscription.
  2. Open the app on the device, then exit the app and restart the device.
  3. Go to the Amazon retail website and search for your app. On the app detail page, select a subscription and click Subscribe.
  4. The purchase screen with price details and legal information appears. Complete the purchase.
  5. On the Fire device, open your app and complete the sign-in flow. The receipt status should not be FULFILLED before the customer completes the sign-in flow.

Expected result: After signing-in, the customer should be able to see the content within the app. Receipt status should be FULFILLED.

↑ Back to top

Last updated: Jun 14, 2024