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 | 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
- Register a Fire TV or Fire tablet with an account that has never purchased your app.
- 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.
- The purchase screen with price details and legal information appears. Complete the purchase.
- 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
- Register a Fire TV or Fire tablet with an account that has never purchased your app.
- Go to the Amazon retail website and search for your app. On the app detail page, select a subscription and click Subscribe.
- The purchase screen with price details and legal information appears. Complete the purchase.
- 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
.
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
- 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.
- 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.
- The purchase screen with price details and legal information appears. Complete the purchase.
- 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
- 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.
- Go to the Amazon retail website and search for your app. On the app detail page, select a subscription and click Subscribe.
- The purchase screen with price details and legal information appears. Complete the purchase.
- 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
.
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
- 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.
- Open your app, then press the Back button to exit the app.
- 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.
- The purchase screen with price details and legal information appears. Complete the purchase.
- 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
- 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.
- On the device, open your app, then press the Back button to exit the app.
- Go to the Amazon retail website and search for your app. On the app detail page, select a subscription and click Subscribe.
- The purchase screen with price details and legal information appears. Complete the purchase.
- 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
.
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 inonResume()
- 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
- 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.
- Open your app, then press the Home button.
- 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.
- The purchase screen with price details and legal information appears. Complete the purchase.
- 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
- 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.
- On the device, open your app, then press the Home button.
- Go to the Amazon retail website and search for your app. On the app detail page, select a subscription and click Subscribe.
- The purchase screen with price details and legal information appears. Complete the purchase.
- 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
.
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
- 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.
- 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.
- 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
- 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.
- Go to the Amazon retail website and search for your app. On the app detail page, select a subscription and click Subscribe.
- The purchase screen with price details and legal information appears. Complete the purchase.
- 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
.
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
- 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.
- Open your app, then press the Back button to exit the app.
- 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.
- 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
- 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.
- Open your app, then press the Back button to exit the app.
- Go to the Amazon retail website and search for your app. On the app detail page, select a subscription and click Subscribe.
- The purchase screen with price details and legal information appears. Complete the purchase.
- 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
.
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
- 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.
- Open your app, then press the Home button.
- 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.
- 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
- 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.
- Open your app, then press the Home button.
- Go to the Amazon retail website and search for your app. On the app detail page, select a subscription and click Subscribe.
- The purchase screen with price details and legal information appears. Complete the purchase.
- 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
.
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
- 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.
- 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
- 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.
- 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.
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
- Register a Fire TV or Fire tablet with an account that has never purchased your app.
- 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.
- The purchase screen with price details and legal information appears. Complete the purchase.
- If the purchase is successful, the app opens automatically. Press the Back button to exit the app before completing the sign-up process.
- 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
- Register a Fire TV or Fire tablet with an account that has never purchased your app.
- Go to the Amazon retail website and search for your app. On the app detail page, select a subscription and click Subscribe.
- The purchase screen with price details and legal information appears. Complete the purchase.
- On the Fire device, open your app, then press the Back button to exit the app before completing the sign-up process.
- 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
.
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
- 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.
- 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.
- The purchase screen with price details and legal information appears. Complete the purchase.
- If the purchase is successful, the app opens automatically. Press the Back button to exit the app before completing the sign-in process.
- 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
- 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.
- Go to the Amazon retail website and search for your app. On the app detail page, select a subscription and click Subscribe.
- The purchase screen with price details and legal information appears. Complete the purchase.
- On the Fire device, open your app, then press the Back button to exit the app before completing the sign-in process.
- 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
.
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
- 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.
- Open your app, then press the Back or Home button.
- 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.
- 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
- 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.
- Open your app, then press the Back or Home button.
- Go to the Amazon retail website and search for your app. On the app detail page, select a subscription and click Subscribe.
- The purchase screen with price details and legal information appears. Complete the purchase.
- 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.
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
- 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.
- Open the app on the device, then exit the app and restart the device.
- 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.
- The purchase screen with price details and legal information appears. Complete the purchase.
- 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
- 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.
- Open the app on the device, then exit the app and restart the device.
- Go to the Amazon retail website and search for your app. On the app detail page, select a subscription and click Subscribe.
- The purchase screen with price details and legal information appears. Complete the purchase.
- 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
.
Last updated: Jun 14, 2024