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

Sample Store - Credit Card Entry with Checkout Service

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.

Overview

This page provides a consolidated view of all the capabilities, APIs, and documentation required to implement a Just Walk Out store using credit card entry where Amazon manages the full payment lifecycle. The retailer calculates pricing and submits the cart to Amazon via the Checkout Service API. Amazon validates the cart, charges the shopper's credit card, and generates the receipt.

Store Profile

Attribute Value
Entry Method Credit card
Identity Verification Amazon-managed
Charge Calculation Order Delegation via Create Purchases API
Payment Processing Amazon-managed via Checkout Service API
Receipts Amazon-managed

APIs in Scope

API Endpoint Purpose
Create Purchases POST /v1/order/purchases Receive cart and calculate pricing (Order Delegation)
Checkout Cart POST /v1/checkout/carts Submit priced cart to Amazon for payment and receipt generation

Required Configurations

The following configurations must be completed in the Merchant Portal and AWS before the store can operate:

Configuration Owner Description
AWS Account Allowlisting (Catalog API) Amazon / Retailer Retailer's AWS account must be allowlisted to invoke the Catalog API
Merchant Portal — Catalog API Amazon Catalog API configured for the merchant in the Merchant Portal
SNS Subscription (Catalog Notifications) Retailer SQS queue subscribed to Amazon's SNS topic for catalog upload results
Ordering Connector — ARN Allowlisting Retailer Ordering Gateway ARNs allowlisted in the retailer's Ordering Connector
Merchant Portal — Ordering Connector Amazon Ordering Connector configured and associated with store(s)
Ordering Connector — Connectivity Test Retailer Connectivity test completed via Merchant Portal
Checkout Service — API Access Amazon / Retailer Retailer's AWS account allowlisted to invoke Checkout Cart API

Available Partners

The following partners have pre-built integrations that support the APIs required for this store model (Catalog, Ordering Connector, and Checkout Integration):

Partner Catalog Ordering Connector Checkout Integration
Cognizant Technology Solutions Yes Yes Yes
MyVenue Yes Yes Yes
retailcloud Yes Yes Yes
Square (Via Daemon) Yes Yes Yes
Tapin2 Yes Yes Yes

The following partners support individual integrations and can be combined to cover all required APIs:

Partner Available Integrations
First Class Nevada Ordering Connector, Checkout Integration
Hudson Ordering Connector, Checkout Integration
Cognizant Technology Solutions Catalog, Ordering Connector, Checkout Integration
RapidRMS Catalog
RIOT Insight Catalog

1. Shopper Entry

Amazon manages gate authorization independently. When a shopper taps their credit card at the gate, Amazon verifies the payment instrument, places a pre-authorization hold, and opens the gate. No retailer callback is involved.

Step Action
1 Shopper taps credit card at gate
2 Amazon verifies payment instrument
3 Amazon places pre-auth on card
4 Gate opens

2. Charge Calculation — Ordering Connector

After the shopper exits, Amazon calls the retailer's Create Purchases API with the virtual shopping cart. The retailer calculates pricing, applies promotions and taxes, and returns a purchaseId. This is the Order Delegation model where the retailer owns charge calculation.

Key Documentation

Topic Link
Charge Calculation Overview Charge Calculation Overview
Setup Charge Calculation Setup
API Setup Configure Charge Calculation API
Charge Calculation API Create Purchases
CloudFormation Templates Ordering Connector CloudFormation Templates

How It Works

  1. Shopper exits the store
  2. Amazon sends the virtual cart to the retailer via POST /v1/order/purchases
  3. Retailer calculates pricing, promotions, and taxes using their POS system
  4. Retailer returns a purchaseId for cross-system tracking
  5. Empty carts return an empty purchaseId and trigger pre-auth cancellation

3. Checkout — Submit Cart to Amazon

After calculating pricing, the retailer submits the priced cart to Amazon via the Checkout Service API. Amazon validates the cart data (line items, totals, promotions, taxes), charges the shopper's credit card, and generates the receipt.

Key Documentation

Topic Link
Checkout Service Overview Checkout Service

How It Works

Step Action
1 Retailer receives cart via Create Purchases API
2 Retailer calculates pricing, promotions, and taxes
3 Retailer calls POST /v1/checkout/carts with the priced cart
4 Amazon validates line items match the original cart
5 Amazon validates order totals (priceTotal = subTotal - promotionsTotal + salesTaxTotal)
6 Amazon charges the shopper's credit card
7 Amazon returns orderId on success (201)

Validation Rules

Amazon validates the checkout payload before processing payment:

Validation Description
Cart content match lineItems must match the cart Amazon sent to the Ordering Connector
Price calculation totalPrice = price - promotions + salesTax for each line item
Order totals priceTotal = subTotal - promotionsTotal + salesTaxTotal
Decimal precision All amounts must be rounded to 2 decimal places
Non-empty cart lineItems array must not be empty
Item pricing Every line item must have a price

Empty Cart Handling

When the shopper exits without taking items, Amazon sends an empty cart to the retailer's Create Purchases API. The retailer returns a valid purchaseId. The retailer does not need to call the Checkout API or cancel the pre-auth — Amazon cancels the pre-auth automatically.

4. Testing

Test Plan

Test Plan Link
Checkout Service Store Test Plan Test Plan

Existing Test Cases

Test Cases Link
Checkout Service Checkout Service Test Cases
Create Purchases Create Purchases Test Cases
Cart Payload Validation Cart Payload Validation Test Cases

Testing Phases

Phase Link
Connectivity Testing Connectivity Testing
End-to-End Testing E2E Testing
Load Testing Load Testing

5. Operational Readiness

Resource Link
Operational Readiness Overview Overview
Checkout Service Store WAR Well-Architected Review

Generate Project Task Lists

📋

Download Project Task Lists

Generate comprehensive project task lists with task owners, status tracking, and acceptance test cases for your Credit Card Entry with Checkout Service JWO store implementation.

Operational Readiness Checklist

✅

Would you like an operational readiness checklist?

Download a checklist covering all operational readiness items for your Credit Card Entry + Checkout Service JWO store launch.

End-to-End Flow

┌─────────────────────────────────────────────────────────────────┐
│                    SHOPPER ENTRY                                 │
│                                                                  │
│  1. Shopper taps credit card at gate                            │
│  2. Amazon verifies payment instrument                          │
│  3. Amazon places pre-auth on card                              │
│  4. Gate opens                                                  │
│                                                                  │
└─────────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                    SHOPPING                                       │
│                                                                  │
│  Shopper picks up items ──► Amazon tracks virtual cart           │
└─────────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                    SHOPPER EXIT & CHARGE CALCULATION              │
│                                                                  │
│  1. Shopper exits store                                         │
│  2. Amazon sends cart to retailer                               │
│  3. Retailer calls ──► POST /v1/order/purchases                 │
│     └── Returns purchaseId (or empty for empty cart)            │
│  4. Retailer calculates pricing, promotions, taxes              │
└─────────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                    CHECKOUT & PAYMENT                             │
│                                                                  │
│  1. Retailer calls ──► POST /v1/checkout/carts                  │
│     ├── Amazon validates cart content and totals                │
│     ├── Amazon charges shopper's credit card                    │
│     └── Returns orderId (201)                                   │
│                                                                  │
│  Empty cart ──► No checkout call ──► Amazon cancels pre-auth    │
└─────────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                    POST-PURCHASE                                  │
│                                                                  │
│  Amazon handles all post-purchase operations:                    │
│  • Receipts available via Just Walk Out receipt portal            │
│  • Refunds managed by Amazon                                     │
│  • Shopper accesses receipt history by payment card               │
└─────────────────────────────────────────────────────────────────┘
Follow us:
amazon_developer_logo

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

Terms

Amazon Developer Blog

Contact Us