Checkout Service Store Validation Plan
- Summary
- APIs Under Validation
- 1. Connectivity Validation
- 2. Charge Calculation Validation (Create Purchases)
- 3. Checkout Cart Validation
- 4. Error Handling Validation
- 5. End-to-End Flow Validation
- 6. Configuration Validation Checklist
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 provides a focused subset of the full Checkout Service Store Test Plan to validate that the partner's integration is correctly configured and functioning for a specific store deployment.
Use this plan when:
- A partner has already built the integration for the Checkout Service model
- 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 |
|---|---|---|
| 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 Ordering Connector Reachable
Test Case ID: VAL-CONN-001 Objective: Verify Amazon can invoke the partner's Ordering Connector (Create Purchases API)
Test Steps:
- Trigger the Merchant Portal connectivity test for the Ordering Connector
- Verify successful response
Expected Result: Connectivity test passes; HTTP 200 returned
1.2 Checkout Cart API Reachable
Test Case ID: VAL-CONN-002 Objective: Verify the partner can invoke Amazon's Checkout Cart API
Test Steps:
- Call
POST /v1/checkout/cartswith valid test data - Verify HTTP 200 response (or expected 400 for test data)
Expected Result: API responds without authentication or network errors
2. Charge Calculation Validation (Create Purchases)
2.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:
- Send a Create Purchases request with one known-price item
- Verify purchaseId is returned
- Verify the calculated price matches the expected catalog price
Expected Result: HTTP 201; purchaseId returned; price correct
2.2 Multi-Item Cart with Promotions
Test Case ID: VAL-OP-002 Objective: Verify promotions are applied correctly
Test Steps:
- Send a Create Purchases request with items that have active promotions
- Verify discounts are applied correctly
Expected Result: HTTP 201; purchaseId returned; promotions applied
2.3 Empty Cart Handling
Test Case ID: VAL-OP-003 Objective: Verify empty cart returns empty purchaseId
Test Steps:
- Send a Create Purchases request with
cartItems: [] - Verify empty purchaseId is returned
Expected Result: HTTP 201; purchaseId: ""
2.4 Tax Calculation
Test Case ID: VAL-OP-004 Objective: Verify tax is calculated correctly for the store's jurisdiction
Test Steps:
- Send a Create Purchases request with taxable items
- Verify tax amount matches expected rate for the store location
Expected Result: HTTP 201; tax calculated correctly
2.5 Idempotency
Test Case ID: VAL-OP-005 Objective: Verify duplicate requests return the same purchaseId
Test Steps:
- Send a Create Purchases request
- Send the same request again with the same idempotentShoppingTripId
- Verify both return the same purchaseId
Expected Result: Same purchaseId returned; no duplicate records
3. Checkout Cart Validation
3.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:
- Complete a shopping trip with items
- Create Purchases returns purchaseId with pricing
- Call Checkout Cart API with the priced cart
- Verify HTTP 200 response
Expected Result: Cart submitted successfully; Amazon processes payment
3.2 Empty Cart Submission
Test Case ID: VAL-CHK-002 Objective: Verify empty cart submission triggers pre-auth cancellation
Test Steps:
- Complete a shopping trip with no items
- Create Purchases returns empty purchaseId
- Call Checkout Cart API with empty cart
- Verify HTTP 200 response
Expected Result: Pre-auth cancelled; no charge
3.3 Cart with Multiple Items
Test Case ID: VAL-CHK-003 Objective: Verify a multi-item priced cart is accepted
Test Steps:
- Complete a shopping trip with multiple items
- Create Purchases returns purchaseId with all items priced
- Call Checkout Cart API with the full priced cart
- Verify HTTP 200 response
Expected Result: All items processed; payment initiated by Amazon
4. Error Handling Validation
4.1 Invalid Request to Checkout Cart
Test Case ID: VAL-ERR-001 Objective: Verify 400 error handling for malformed Checkout Cart requests
Test Steps:
- Call Checkout Cart API with missing required fields
- Verify HTTP 400 response
Expected Result: HTTP 400; error handled gracefully
4.2 Rate Limit Handling
Test Case ID: VAL-ERR-002 Objective: Verify the partner handles 429 responses correctly
Test Steps:
- Trigger a 429 response (or simulate)
- Verify the system retries after the Retry-After period
Expected Result: System retries with backoff; no data loss
4.3 Server Error Retry
Test Case ID: VAL-ERR-003 Objective: Verify the partner retries on 500/503 errors
Test Steps:
- Trigger a transient 500 error (or simulate)
- Verify the system retries with exponential backoff
Expected Result: Retry succeeds; no duplicate submissions
5. End-to-End Flow Validation
5.1 Complete Shopping Journey — Checkout Service
Test Case ID: VAL-E2E-001 Objective: Validate the full shopper journey from entry to Amazon-managed payment
Test Steps:
- Shopper taps credit card at gate → gate opens
- Shopper picks up items and exits
- Amazon sends cart → Create Purchases returns purchaseId with correct pricing
- Partner calls Checkout Cart API with priced cart → success
- Amazon processes payment and generates receipt
Expected Result: Seamless end-to-end flow; Amazon handles payment and receipt
5.2 Empty Cart Journey
Test Case ID: VAL-E2E-002 Objective: Validate the empty cart flow
Test Steps:
- Shopper enters store and exits without items
- Amazon sends empty cart → Create Purchases returns empty purchaseId
- Partner calls Checkout Cart API with empty cart → success
- No charge on shopper's card
Expected Result: Pre-auth released; no charge
6. Configuration Validation Checklist
| Configuration | Validated | Notes |
|---|---|---|
| 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 | ☐ |
