Amazon Developer

Console

as

Settings
Sign out
Notifications
Alexa
Amazon Appstore
Ring
AWS
Documentation
Support
Contact Us
My Cases

Console

as

Docs
Resources
Ecommerce Plug-ins
Publish
Connect

App Entry + Checkout Service Validation Plan

Disclaimer: This document contains sample content for illustrative purposes only. Organizations should follow their own established best practices, security requirements, and compliance standards to ensure solutions are production-ready.

Summary

This validation plan is designed for existing partners who have pre-built integrations and do not need to build from scratch. It validates that the partner's integration is correctly configured and functioning for a store that uses app-based entry (Verify Identity Keys) combined with Amazon-managed payment (Checkout Service).

Use this plan when:

  • A partner has already built the integration for app-based entry with Checkout Service
  • The store is being onboarded using an existing partner solution
  • You need to confirm connectivity, configuration, and end-to-end flow correctness without re-testing the full build

APIs Under Validation

API Endpoint Validation Focus
Verify Identity Keys POST /v1/identity/identity-keys Connectivity, valid/invalid key handling
Create Purchases POST /v1/order/purchases Connectivity, pricing accuracy, empty cart handling
Checkout Cart POST /v1/checkout/carts Connectivity, successful submission, error handling

1. Connectivity Validation

1.1 Verify Identity Keys API Reachable

Test Case ID: VAL-CONN-001 Objective: Verify the partner can receive calls to the Verify Identity Keys API

Test Steps:

  1. Trigger the Merchant Portal connectivity test for the Identity Connector
  2. Verify successful response

Expected Result: Connectivity test passes; HTTP 200 returned

1.2 Ordering Connector Reachable

Test Case ID: VAL-CONN-002 Objective: Verify Amazon can invoke the partner's Ordering Connector (Create Purchases API)

Test Steps:

  1. Trigger the Merchant Portal connectivity test for the Ordering Connector
  2. Verify successful response

Expected Result: Connectivity test passes; HTTP 200 returned

1.3 Checkout Cart API Reachable

Test Case ID: VAL-CONN-003 Objective: Verify the partner can invoke Amazon's Checkout Cart API

Test Steps:

  1. Call POST /v1/checkout/carts with valid test data
  2. Verify HTTP 201 response (or expected 400 for test data)

Expected Result: API responds without authentication or network errors

2. Identity Verification Validation

2.1 Valid Identity Key — Successful Entry

Test Case ID: VAL-ID-001 Objective: Verify a valid identity key is accepted and shopper is authorized

Test Steps:

  1. Call Verify Identity Keys with a valid base64-encoded identity key
  2. Verify response contains VALID status
  3. Verify gate opens

Expected Result: HTTP 200; identity verified; gate opens

2.2 Invalid Identity Key — Entry Denied

Test Case ID: VAL-ID-002 Objective: Verify an invalid identity key is rejected

Test Steps:

  1. Call Verify Identity Keys with an invalid or expired identity key
  2. Verify response indicates invalid key

Expected Result: Entry denied; appropriate error response

2.3 Correct Key Channel

Test Case ID: VAL-ID-003 Objective: Verify the correct keyChannel (OPTICAL) is used for QR code scanning

Test Steps:

  1. Call Verify Identity Keys with keyChannel: OPTICAL
  2. Verify successful response

Expected Result: HTTP 200; key channel accepted

3. Charge Calculation Validation (Create Purchases)

3.1 Single Item Cart — Correct Pricing

Test Case ID: VAL-OP-001 Objective: Verify the partner's Ordering Connector returns correct pricing for a single item

Test Steps:

  1. Send a Create Purchases request with one known-price item
  2. Verify purchaseId is returned
  3. Verify the calculated price matches the expected catalog price

Expected Result: HTTP 201; purchaseId returned; price correct

3.2 Multi-Item Cart with Promotions

Test Case ID: VAL-OP-002 Objective: Verify promotions are applied correctly

Test Steps:

  1. Send a Create Purchases request with items that have active promotions
  2. Verify discounts are applied correctly

Expected Result: HTTP 201; purchaseId returned; promotions applied

3.3 Empty Cart Handling

Test Case ID: VAL-OP-003 Objective: Verify empty cart returns empty purchaseId

Test Steps:

  1. Send a Create Purchases request with cartItems: []
  2. Verify empty purchaseId is returned

Expected Result: HTTP 201; purchaseId: ""

3.4 Tax Calculation

Test Case ID: VAL-OP-004 Objective: Verify tax is calculated correctly for the store's jurisdiction

Test Steps:

  1. Send a Create Purchases request with taxable items
  2. Verify tax amount matches expected rate for the store location

Expected Result: HTTP 201; tax calculated correctly

3.5 Idempotency

Test Case ID: VAL-OP-005 Objective: Verify duplicate requests return the same purchaseId

Test Steps:

  1. Send a Create Purchases request
  2. Send the same request again with the same idempotentShoppingTripId
  3. Verify both return the same purchaseId

Expected Result: Same purchaseId returned; no duplicate records

4. Checkout Cart Validation

4.1 Successful Cart Submission

Test Case ID: VAL-CHK-001 Objective: Verify the partner can submit a priced cart to Amazon for payment processing

Test Steps:

  1. Complete a shopping trip with items
  2. Create Purchases returns purchaseId with pricing
  3. Call Checkout Cart API with the priced cart
  4. Verify HTTP 201 response with orderId

Expected Result: Cart submitted successfully; Amazon processes payment

4.2 Cart with Multiple Items

Test Case ID: VAL-CHK-002 Objective: Verify a multi-item priced cart is accepted

Test Steps:

  1. Complete a shopping trip with multiple items
  2. Create Purchases returns purchaseId with all items priced
  3. Call Checkout Cart API with the full priced cart
  4. Verify HTTP 201 response

Expected Result: All items processed; payment initiated by Amazon

4.3 Cart Validation — Price Totals

Test Case ID: VAL-CHK-003 Objective: Verify Amazon accepts the cart when price totals are correct

Test Steps:

  1. Submit a cart where priceTotal = subTotal - promotionsTotal + salesTaxTotal
  2. Verify HTTP 201 response

Expected Result: Cart accepted; validation passes

4.4 Empty Cart — Pre-Auth Cancellation

Test Case ID: VAL-CHK-004 Objective: Verify empty cart flow triggers automatic pre-auth cancellation

Test Steps:

  1. Shopper exits without items
  2. Create Purchases returns empty purchaseId
  3. Retailer does NOT call Checkout Cart API
  4. Verify Amazon cancels pre-auth automatically

Expected Result: Pre-auth cancelled; no charge to shopper

5. Error Handling Validation

5.1 Invalid Identity Key Format

Test Case ID: VAL-ERR-001 Objective: Verify 400 error handling for malformed identity key

Test Steps:

  1. Call Verify Identity Keys with a malformed identity key
  2. Verify appropriate error response

Expected Result: Error handled gracefully; no system crash

5.2 Invalid Checkout Cart Request

Test Case ID: VAL-ERR-002 Objective: Verify 400 error handling for malformed Checkout Cart requests

Test Steps:

  1. Call Checkout Cart API with missing required fields
  2. Verify HTTP 400 response

Expected Result: HTTP 400; error handled gracefully

5.3 Rate Limit Handling

Test Case ID: VAL-ERR-003 Objective: Verify the partner handles 429 responses correctly

Test Steps:

  1. Trigger a 429 response (or simulate)
  2. Verify the system retries after the Retry-After period

Expected Result: System retries with backoff; no data loss

5.4 Server Error Retry

Test Case ID: VAL-ERR-004 Objective: Verify the partner retries on 500/503 errors from Checkout Cart API

Test Steps:

  1. Trigger a transient 500 error (or simulate)
  2. Verify the system retries with exponential backoff

Expected Result: Retry succeeds; no duplicate submissions

6. End-to-End Flow Validation

6.1 Complete Shopping Journey — App Entry + Checkout Service

Test Case ID: VAL-E2E-001 Objective: Validate the full shopper journey from app entry to Amazon-managed payment

Test Steps:

  1. Shopper scans QR code at gate
  2. Verify Identity Keys returns VALID → gate opens
  3. Shopper picks up items and exits
  4. Amazon sends cart → Create Purchases returns purchaseId with correct pricing
  5. Partner calls Checkout Cart API with priced cart → HTTP 201
  6. Amazon processes payment and generates receipt

Expected Result: Seamless end-to-end flow; identity verified, pricing calculated, Amazon handles payment and receipt

6.2 Empty Cart Journey

Test Case ID: VAL-E2E-002 Objective: Validate the empty cart flow

Test Steps:

  1. Shopper enters store via app and exits without items
  2. Amazon sends empty cart → Create Purchases returns empty purchaseId
  3. Amazon cancels pre-auth automatically
  4. No charge on shopper's payment method

Expected Result: Empty purchaseId returned; pre-auth released; no charge

7. Configuration Validation Checklist

Configuration Validated Notes
Identity Connector ARN allowlisted ☐  
Identity Connector configured in Merchant Portal ☐  
Identity Connector connectivity test passed ☐  
Ordering Connector ARN allowlisted ☐  
Ordering Connector configured in Merchant Portal ☐  
Ordering Connector connectivity test passed ☐  
Checkout Cart API allowlisted ☐  
Store ID correctly mapped ☐  
Catalog uploaded and active ☐  
Mobile app QR code generation configured ☐  
Follow us:
amazon_developer_logo

© 2010-2026, Amazon.com, Inc. or its affiliates. All Rights Reserved.

Terms

Amazon Developer Blog

Contact Us