Skip to content

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.

your-store.com/checkout
S
Shipping address
order #10482

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

See pricing

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.