Drop-in widget, one script tag
Catch bad addresses
at checkout
Checkout Guard checks the address when the customer stops typing and shows a correction beside the form. Your storefront still decides whether checkout continues.
Free accounts get a sandbox key. The live widget comes with Growth ($79 a month) and above, with no SDK or build step.
Tap a scenario. The badge messages are the live widget's own; the store form around them is a mock.
Install
Works with theme-owned Shopify forms, WooCommerce, Magento and custom HTML address forms.
Paste this above </body>. The widget finds your address fields on its own.
<script
src="https://revaddress.com/sdk/revaddress-guard.js"
data-api-key="rv_live_pub_YOUR_KEY"
defer
></script>
- Under 3 KB gzipped, with no jQuery and no dependencies
- Finds common field names and form layouts
- Refuses secret keys: the endpoint accepts publishable keys only
- Respects reduced-motion settings and screen readers
Set the target form and field selectors
<script
src="https://revaddress.com/sdk/revaddress-guard.js"
data-api-key="rv_live_pub_YOUR_KEY"
data-target="#shipping-address-form"
data-field-street="[name='shipping_address[address1]']"
data-field-city="[name='shipping_address[city]']"
data-field-state="[name='shipping_address[province]']"
data-field-zip="[name='shipping_address[zip]']"
defer
></script>
How the badge decides
The widget waits 600 milliseconds after typing stops, calls the restricted browser endpoint, and keeps its badge isolated from merchant CSS.
Typo correction
A correction is returned only when the standardized street or city differs from the input. The customer can accept it without leaving the form.
USPS deliverability
DPV confirmation, ZIP+4, CMRA, vacancy and USPS-derived risk signals run on the merchant's connected USPS license. DPV returns a valid, missing-unit, undeliverable or risky state. Call a result USPS-verified when it comes from that license.
Checkout keeps moving
On an upstream error, the endpoint returns a neutral valid response with no message and the badge hides, so the order goes through. Monitor the integration to keep a record that every check ran.
Plan access
Free sandbox
A test publishable key returns deterministic badge states without a live upstream call.
Test only
Growth
The live widget on the plan's shared allowance of 25,000 requests a month, with verified states on a connected USPS license.
$79 a month
Pro and Enterprise
The same widget with higher allowances, usage analytics, and multi-merchant isolation on the plans that include it.
from $199 a month
How it fits your checkout
A browser badge is one signal inside checkout.
Submit behavior
The merchant decides on submit
The shipped widget renders a badge. To gate an order, call the endpoint from checkout code and apply the merchant's own review rule.
Platform
Runs on a form you control
Use the script on custom HTML, WooCommerce, Magento or a theme-owned form. Shopify's hosted checkout takes a Checkout UI Extension instead of a script tag.
Test it in the sandbox
A sandbox key returns a fixed state for each of four test streets. Run them, then compare the Growth allowance and the license requirement.
Already on Growth or above? Create the publishable key in the dashboard. Free accounts get a sandbox key for testing only.