Quick Subscribe Test Cases

Important: At this time, Quick Subscribe is available to select partners only.

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

Note: Test cases with an 'a' suffix use one-click account information sharing where a customer consents to share their name, email, and zip code with your app to create an account. Test cases with a 'b' suffix use the standard account creation method.

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

Case 1a

Description:

A new customer who has never purchased your app, purchases a subscription by clicking Subscribe & Get on a device or Subscribe Now on the retail web page. The customer gives consent to share their account details by selecting Use this info to create an account within the app.

Result:

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

Feature or scenario tested:

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

Case 1a: 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.
The consent screen with title, terms and conditions, and customer details (name, email, zip code) appears, and indicates Amazon will share information with a third-party vendor for creating the customer's account. Click Use this info.

Expected result: A Thank You page appears with the subscription term details and a dismiss button. The app opens automatically and the customer should be able to see the content within the app. Receipt status should be FULFILLED.

Case 1a: 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, search for your app, select the Quick Subscribe offer, and click Subscribe Now.
A purchase pop-up appears with price and legal information. To finalize the purchase, click Subscribe Now.
A consent pop-up shows customer details and terms, which indicates Amazon will share information with a third-party vendor for creating the customer's account. To proceed, click Use this info.

Case 1b

Description:

A new customer who has never purchased your app, purchases a subscription by clicking Subscribe & Get on a device or Subscribe Now 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 1b: 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 1b: 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 Now.
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.

↑ Back to top

Case 2a

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 Now on the retail web page. The customer gives consent to share their account details by selecting Use this info to create an account within the app.

Result:

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

Feature or scenario tested:

getUserData() and 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 2a: 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.
The consent screen with title, terms and conditions, and customer details (name, email, zip code) appears, and indicates Amazon will share information with a third-party vendor for creating the customer's account. Click Use this info.

Case 2a: 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, search for your app, select the Quick Subscribe offer, and click Subscribe Now.
A purchase pop-up appears with price and legal information. To finalize the purchase, click Subscribe Now.
A consent pop-up shows customer details and terms, which indicates Amazon will share information with a third-party vendor for creating the customer's account. To proceed, click Use this info.

Case 2b

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 Now 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 2b: 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 2b: 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 Now.
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.

↑ Back to top

Case 3a

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 Now on the retail web page. The customer gives consent to share their account details by selecting Use this info to create an account within the app.

Result:

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

Feature or scenario tested:

getUserData() and getPurchaseUpdate() method call on app launch and onResume()
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 3a: 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.
The consent screen with title, terms and conditions, and customer details (name, email, zip code) appears, and indicates Amazon will share information with a third-party vendor for creating the customer's account. Click Use this info.

Case 3a: 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, search for your app, select the Quick Subscribe offer, and click Subscribe Now.
A purchase pop-up appears with price and legal information. To finalize the purchase, click Subscribe Now.
A consent pop-up shows customer details and terms, which indicates Amazon will share information with a third-party vendor for creating the customer's account. To proceed, click Use this info.

Case 3b

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 Now 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 3b: 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 3b: 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 Now.
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.

↑ Back to top

Case 4a

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 Now on the retail web page. The customer gives consent to share their account details by selecting Use this info to create an account within the app.

Result:

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

Feature or scenario tested:

getUserData() and 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 4a: 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.
The consent screen with title, terms and conditions, and customer details (name, email, zip code) appears, and indicates Amazon will share information with a third-party vendor for creating the customer's account. Click Use this info.

Case 4a: 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, search for your app, select the Quick Subscribe offer, and click Subscribe Now.
A purchase pop-up appears with price and legal information. To finalize the purchase, click Subscribe Now.
A consent pop-up shows customer details and terms, which indicates Amazon will share information with a third-party vendor for creating the customer's account. To proceed, click Use this info.

Case 4b

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 Now 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 4b: 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 4b: 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 Now.
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.

↑ Back to top

Case 5a

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 Now 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:

getUserData() and 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 5a: 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.
The consent screen with title, terms and conditions, and customer details (name, email, zip code) appears, and indicates Amazon will share information with a third-party vendor for creating the customer's account. Click Use this info.

Case 5a: 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, search for your app, select the Quick Subscribe offer, and click Subscribe Now.
A purchase pop-up appears with price and legal information. To finalize the purchase, click Subscribe Now.
A consent pop-up shows customer details and terms, which indicates Amazon will share information with a third-party vendor for creating the customer's account. To proceed, click Use this info.

Case 5b

Description:

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 5b: 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 5b: 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 Now.
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.

↑ Back to top

Case 6a

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 Now 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:

getUserData() and getPurchaseUpdate() method call on app launch and in onResume()
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 6a: 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.
The consent screen with title, terms and conditions, and customer details (name, email, zip code) appears, and indicates Amazon will share information with a third-party vendor for creating the customer's account. Click Use this info.

Case 6a: 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, search for your app, select the Quick Subscribe offer, and click Subscribe Now.
A purchase pop-up appears with price and legal information. To finalize the purchase, click Subscribe Now.
A consent pop-up shows customer details and terms, which indicates Amazon will share information with a third-party vendor for creating the customer's account. To proceed, click Use this info.

Case 6b

Description:

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 6b: 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 6b: 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 Now.
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.

↑ Back to top

Case 7a

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 Now 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:

getUserData() and getPurchaseUpdate() method call on app launch and in onResume()
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 7a: 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.
The consent screen with title, terms and conditions, and customer details (name, email, zip code) appears, and indicates Amazon will share information with a third-party vendor for creating the customer's account. Click Use this info.

Case 7a: 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, search for your app, select the Quick Subscribe offer, and click Subscribe Now.
A purchase pop-up appears with price and legal information. To finalize the purchase, click Subscribe Now.
A consent pop-up shows customer details and terms, which indicates Amazon will share information with a third-party vendor for creating the customer's account. To proceed, click Use this info.

Case 7b

Description:

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 7b: 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 7b: 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 Now.
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.

↑ 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

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.

↑ Back to top

Case 9a

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 customer consent status is delivered through getUserData(), the account is created
After receipt is delivered through getPurchaseUpdates(), it persists and is fulfilled

Case 9a: 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.
The consent screen with title, terms and conditions, and customer details (name, email, zip code) appears, and indicates Amazon will share information with a third-party vendor for creating the customer's account. Click Enter Info Later.
A Thank You page appears with subscription term details and a dismiss button. 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 9a: 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 Now.
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 9b

Description:

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 9b: 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 9b: 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 Now.
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.

↑ Back to top

Case 10a

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 Now 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 customer consent status is delivered through getUserData(), the account is created
After receipt is delivered through getPurchaseUpdates(), it persists and is fulfilled

Case 10a: 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.
The consent screen with title, terms and conditions, and customer details (name, email, zip code) appears, and indicates Amazon will share information with a third-party vendor for creating the customer's account. Click Enter Info Later.
A Thank You page appears with subscription term details and a dismiss button. If the purchase is successful, the app opens automatically. Press the Back button to exit the app before completing the sign-in flow.
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 10a: 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 Now.
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 10b

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 Now 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 10b: 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 10b: 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 Now.
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.

↑ Back to top

Case 11a

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 Now on the retail web page. The customer gives consent to share their account details by selecting Use this info to create an account within the app.

Result:

The purchase completes successfully and the customer account is created. 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:

After customer consent status is delivered through getUserData(), the account is created
The latest receipt is delivered to the app, rather than the last getPurchaseUpdates() response from the internal app cache

Case 11a: 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.
The consent screen with title, terms and conditions, and customer details (name, email, zip code) appears, and indicates Amazon will share information with a third-party vendor for creating the customer's account. Click Use this info.

Expected result: A Thank You page appears with subscription term details and a dismiss button. 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 clicks Enter Info Later in the consent pop-up and completes the sign-in flow.

Case 11a: 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, search for your app, select the Quick Subscribe offer, and click Subscribe Now.
A purchase pop-up appears with price and legal information. To finalize the purchase, click Subscribe Now.
A consent pop-up shows customer details and terms, which indicates information will be shared with a third-party vendor for account creation. To proceed, click Use this info.

Expected result: On the website, a Thank You page with the subscription details appears. On the registered Fire device, a notification appears that confirms the subscription, and the app automatically launches. In the app, 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 clicks Enter Info Later in the consent pop-up and completes the sign-in flow.

Case 11b

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 Now 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 11b: 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 11b: 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 Now.
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.

↑ Back to top

Case 12a

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 Now on the retail web page. The customer gives consent to share their account details by selecting Use this info to create an account within the app.

Result:

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

Feature or scenario tested:

After customer consent status is delivered through getUserData(), the account is created
After receipt is delivered through getPurchaseUpdates(), it persists and is fulfilled

Case 12a: 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.
The consent screen with title, terms and conditions, and customer details (name, email, zip code) appears, and indicates Amazon will share information with a third-party vendor for creating the customer's account. Click Use this info.

Expected result: A Thank You page appears with subscription term details and a dismiss button. The app opens automatically and the customer account is created within the app. After the app launches, the customer should be able to see the content within the app and the receipt status should be FULFILLED.

Case 12a: 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, search for your app, select the Quick Subscribe offer, and click Subscribe Now.
A purchase pop-up appears with price and legal information. To finalize the purchase, click Subscribe Now.
A consent pop-up shows customer details and terms, which indicates information will be shared with a third-party vendor for account creation. To proceed, click Use this info.

Expected result: On the website, a Thank You page with the subscription details appears. After app launches on the device, the customer should be able to see the content within the app. Receipt status should be FULFILLED.

Case 12b

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 Now 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 12b: 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 12b: 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 Now.
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.

↑ Back to top

Case 13

Description:

A customer has an existing subscription that was purchased outside of Amazon and uses Quick Subscribe to purchase the same subscription on the same account.

Result:

The app sends UNAVAILABLE in the notifyfulfillment() method call. The customer can start streaming content with their existing subscription.

Feature or scenario tested:

getPurchaseUpdate() method call on app launch
Quick Subscribe implementation for a customer with an overlapping subscription
Acknowledge Receipt API or notifyFulfillment() method call with UNAVAILABLE

Case 13: Test steps for Fire TV or Fire tablet

Go to your company's website that lists available subscription plans for your app.
Subscribe to a plan on the website with an email and password.
On a Fire TV, go to the app detail page and use the subscribe option to make a purchase with Quick Subscribe.
Sign in to the app on the Fire TV using the same email and password from step 2.

Expected result: The app launches and calls the Acknowledge Receipt API or notifyFulfillment() method and sends the fulfillment result UNAVAILABLE. The customer can start streaming content with their existing subscription.

Case 13: Test steps for retail web

Go to your company's website that lists available subscription plans for your app.
Subscribe to a plan on the website with an email and password.
On the app's retail web page, use the subscribe option to make a purchase with Quick Subscribe.
Sign in to the app on the Fire TV using the same email and password from step 2.

↑ Back to top

Last updated: Oct 23, 2024