Address Restriction Samples


When you create a Checkout Session, you can use the DeliverySpecifications parameter to specify shipping restrictions to prevent buyers from selecting unsupported addresses from their Amazon address book. Below are samples for handling common use-cases.

Allow US addresses only

{
    "webCheckoutDetails": {
        "checkoutReviewReturnUrl": "https://a.com/merchant-review-page"
    },
    "storeId": "amzn1.application-oa2-client.c48db267f2d44b6bbe2f65aadee22ea6",
    "deliverySpecifications": {
        "addressRestrictions": {
            "type": "Allowed",
            "restrictions": {
                "US": {
                }
            }
        }
    }
}  

Allow continental US addresses only

{
    "webCheckoutDetails": {
        "checkoutReviewReturnUrl": "https://a.com/merchant-review-page"
    },
    "storeId": "amzn1.application-oa2-client.c48db267f2d44b6bbe2f65aadee22ea6",
    "deliverySpecifications": {
        "addressRestrictions": {
            "type": "NotAllowed",
            "restrictions": {
                "US": {
                    "statesOrRegions":["AK","HI"]
                },
                "GB": {
                },
                "DE": {
                },
                "FR": {
                },
                "IT": {
                },
                "ES": {
                },
                "IN": {
                },
                "JP": {
                }
            }
        }
    }
}  

Allow EU addresses only

{
    "webCheckoutDetails": {
        "checkoutReviewReturnUrl": "https://a.com/merchant-review-page"
    },
    "storeId": "amzn1.application-oa2-client.c48db267f2d44b6bbe2f65aadee22ea6",
    "deliverySpecifications": {
        "addressRestrictions": {
            "type": "Allowed",
            "restrictions": {
                "AT": {
                },
                "BE": {
                },
                "BG": {
                },
                "HR": {
                },
                "CY": {
                },
                "CZ": {
                },
                "DK": {
                },
                "EE": {
                },
                "FI": {
                },
                "FR": {
                },
                "DE": {
                },
                "GR": {
                },
                "HU": {
                },
                "IE": {
                },
                "IT": {
                },
                "LV": {
                },
                "LT": {
                },
                "LU": {
                },
                "MT": {
                },
                "NL": {
                },
                "PL": {
                },
                "PT": {
                },
                "RO": {
                },
                "SK": {
                },
                "SI": {
                },
                "ES": {
                },
                "SE": {
                }
            }
        }
    }
}  

Restrict specific ZIP codes

{
    "webCheckoutDetails": {
        "checkoutReviewReturnUrl": "https://a.com/merchant-review-page"
    },
    "storeId": "amzn1.application-oa2-client.c48db267f2d44b6bbe2f65aadee22ea6",
    "deliverySpecifications": {
        "addressRestrictions": {
            "type": "NotAllowed",
            "restrictions": {
                "US": {
                    "zipCodes": ["12345", "55555"]
                }
            }
        }
    }
}  

Restrict PO box addresses

{
    "webCheckoutDetails": {
        "checkoutReviewReturnUrl": "https://a.com/merchant-review-page"
    },
    "storeId": "amzn1.application-oa2-client.c48db267f2d44b6bbe2f65aadee22ea6",
    "deliverySpecifications": {
        "specialRestrictions": ["RestrictPOBoxes"]
    }
} 

Restrict packstation addresses

{
    "webCheckoutDetails": {
        "checkoutReviewReturnUrl":"https://a.com/merchant-review-page"
    },
    "storeId": "amzn1.application-oa2-client.c48db267f2d44b6bbe2f65aadee22ea6",
    "deliverySpecifications": {
        "specialRestrictions": ["RestrictPackstations"]
    }
}