App Shopify
Checkout
The checkout address check, address suggestions, the email check and the checkout rules, which of them need Shopify Plus, and how wallets behave.
Address Validation iO can catch a wrong address while the customer is still in checkout, so the mistake is fixed before the order exists. Every store can use the checkout rules. Shopify only lets apps show blocks and address suggestions inside checkout on Shopify Plus, so the address check, the email check and AVIO's suggestions need Plus. AVIO checks the address again after the order either way.
What needs Shopify Plus
| Feature | Shopify Plus | Other plans |
|---|---|---|
| Address check with suggested corrections | Yes | No |
| "Block checkout for invalid addresses" | Yes | No |
| AVIO address suggestions while typing | Yes | No, Shopify's own suggestions |
| Email check (typo and disposable hints) | Yes | No |
| Checkout rules | Yes | Yes |
| Check after the order, correction notice and email | Yes | Yes |
The address check (Shopify Plus)
Add the "Address Validation iO address check" block in Shopify's checkout editor (Home → Setup links there). You can place it:
- at one of two fixed spots between the delivery address and the shipping methods (above or below the shipping method heading), or
- as a block anywhere in checkout, for example in the order summary.
Once street, city, postal code and country are filled in, AVIO checks the address in the background. A Valid address shows nothing. For Needs checking or Invalid, a notice says what looks wrong, for example "Please add the house number.", offers up to three "Use …" buttons with suggested corrections and a Keep my address button.
When a customer keeps their address, the order gets the tag address-validation|checkout|confirmed and the admin order block notes it.
Placement tips:
- The fixed spot above the shipping method heading shows only while the address form is open.
- On a three-page checkout the fixed spots appear on the shipping step. A block runs only on the steps that show it.
- On Shopify's one-page review for returning signed-in customers, the fixed spots stay hidden until the customer opens the shipping methods. A block placement, such as the order summary, covers them.
- Placing the block more than once shows more than one notice.
In the checkout editor the block shows a sample address and notice with your design and texts. Nothing is checked or billed there.
Checkout never waits for AVIO. If a check is slow or fails, no notice appears and the order is checked after it is placed.
Blocking invalid addresses
By default the notice only warns. Turn on Block checkout for invalid addresses under Settings → Checkout and a customer can't pay with an Invalid address; Keep my address disappears. Needs checking never blocks.
When an Invalid address blocks, the customer sees the error at the field to fix (street, city or postal code). Blocking needs Check the address during checkout on and the checkout rules active, because the rules enforce the block. On a three-page checkout, place the block where it shows on every step, such as the order summary.
Shopify's own address validation
With the AVIO block in your checkout, turn off Shopify's "Validate shipping address" (Shopify admin → Settings → Checkout → Address collection). Both suggest corrections, and Shopify advises using one or the other.
Info banner (optional)
The optional "Address Validation iO info banner" block sits above the pay button. It shows the status of the address check and, for a German Packstation or post office without the DHL Postnummer, a field where the customer adds the number.
Address suggestions while typing (Shopify Plus)
By default, Shopify's checkout suggests addresses from its own data while the customer types. On Shopify Plus you can replace them with AVIO's suggestions from postal data.
- Turn on Show Address Validation iO's address suggestions in checkout under Settings → Checkout. It is off by default and only works while Check the address during checkout is on.
- For suggestions in checkout's own address field: in Shopify admin, go to Settings → Checkout → Customize. In the checkout editor, open Settings → Address autocompletion, keep "Use address autocompletion" on and select Address Validation iO address suggestions.
- The same switch shows a "Find your address" search field above the delivery address form. If your checkout doesn't show it, add the "Address Validation iO address check" block at the start of the delivery address in the checkout editor.
After 3 characters, AVIO lists up to five complete addresses for the customer's selected country. A pick fills in the address fields. AVIO still checks the picked address.
Note: While AVIO is selected, Shopify doesn't fall back to its own suggestions. If you turn AVIO's suggestions off, also deselect AVIO in the checkout editor, or your customers get no suggestions at all.
Typing is free. Each address a customer picks is billed like a validated order, and the order that follows isn't billed again. See pricing.
The list can be empty when AVIO is paused or at its spending cap, when fewer than 3 characters are typed, or when a provider is briefly slow or busy. The customer then types the address as usual.
Email check (Shopify Plus)
The "Address Validation iO email check" block sits in the contact section of checkout. It shows hints for likely typos (for example gmial.com) and disposable addresses. It only warns, never blocks, and is free. To block bad emails, use the email checkout rules below. More in Email and phone checks.
Checkout rules
The checkout rules are simple format rules that run inside checkout on every Shopify plan, without asking a provider. When one fails, the customer sees an error at the field and can't pay until it is fixed.
Activate them once on Home (Activate checkout rules). To turn them off, deactivate "Address Validation iO checkout rules" under Checkout rules in your Shopify checkout settings. They don't run on the cart page or for pickup and local delivery.
| Rule | Where | Default |
|---|---|---|
| "Require a house number in" | Settings → Checkout | Germany, Austria, Switzerland, Netherlands |
| "Check the postal code format for" | Settings → Checkout | Germany, Austria, Switzerland, Netherlands |
| "Maximum characters per address line" | Settings → Checkout | 0 (off) |
| "Block malformed email addresses" | Settings → Customer contact | On |
| "Block disposable email addresses (e.g. Mailinator, YOPmail)" | Settings → Customer contact | Off; needs email checks on |
| PO boxes and parcel lockers | Settings → Delivery points | Accepted. A German Packstation without the DHL Postnummer is always stopped |
| Address rules set to Block | Settings → Address rules | None |
The email rules ignore logged-in customers. Edit the error messages under Design & language → Edit texts.
While AVIO is paused or at its spending cap, the address check stops, but the checkout rules keep working.
Settings and defaults
Under Settings → Checkout:
| Setting | Default |
|---|---|
| "Check the address during checkout" | On |
| "Block checkout for invalid addresses" | Off |
| "Show Address Validation iO's address suggestions in checkout" | Off |
The look and texts of the notice are under Design & language.
Express checkout and wallets
Shop Pay, Apple Pay, Google Pay and PayPal let customers pay in a few taps, often from the product or cart page. AVIO checks these orders after purchase like any other. Before purchase it can do less, because Shopify decides which apps appear in a wallet payment.
| What | With a wallet payment |
|---|---|
| The check after the order | Works as for any order, with the wallet's address |
| The address check (Shopify Plus) | Never shows in Apple Pay, Google Pay or PayPal. In Shop Pay only if you turn on "Include app in Shop Pay" for the block in Shopify |
| Checkout rules | Still run and block the payment, but the wallet may show an unclear error, or none |
| "Block checkout for invalid addresses" | Rarely applies: it blocks only an address the AVIO notice already marked Invalid in this checkout |
If unclear wallet errors matter more to you than blocking, you can hide the wallet buttons on product and cart pages in your theme settings. AVIO never changes your theme.
Troubleshooting
The address check doesn't show (Shopify Plus). Check that the block is placed in the checkout editor, validation is active on Home, Check the address during checkout is on and the spending cap isn't reached. If the address breaks a checkout rule, such as a missing house number, the rule's error shows instead of the notice.
A Block rule or delivery point setting didn't stop checkout. The checkout rules probably aren't activated. The order is still marked Invalid after it is placed.