This product is only available to customers with a verified ID.
``` ## Styling the start verification button The button that starts verification is customizable without code through the [appearance section in the settings](../theming/branding.md). But if that doesn't meet your exact criteria, you can use CSS within your site's theme to modify additional properties such as the border, border radius, shadows and more. The Real ID verification button has the class name `.real-id-start-verification`, which you can use to apply custom styling via CSS rules. Here is an example: ``` button.real-id-start-verification { border-radius: 5px; /* Adjust the value to control the amount of rounding */ } ``` ## Troubleshooting ### Occasionally unverified customers checkout If your seeing orders come through occasionally where customers can still checkout without completeing their ID check, you can follow these steps.Loading...
{% endif %} // highlight-endWe require all customers to verify their ID as a part of account registration.
This one time ID verification is instant and secure through our partner Real ID.
To continue with checkout, please login and verify your ID.
This process is instant and only needs to be done once.
Customer's ID scanned by Real ID. Scan ID: {{ scan_id }}
{% endif %} ``` The `if scan_id.size > 0` check makes sure the line only prints when an ID was actually scanned for that sale. Non-scanned sales print the receipt without it, so you can add this snippet to your default template without affecting other orders. Save the template, then use the **Preview** feature to test against an order that had an ID scanned. You should see the line render at the bottom of the preview. ## Optional: debug snippet If the line doesn't appear when you expect it to, drop this debug block into your receipt template and preview a receipt. It dumps everything the template can read about each line item's custom attributes, which helps you confirm whether the scan ID was actually attached. ```liquid--- DEBUG START ---
order.line_items.size = {{ order.line_items.size }}
{% for li in order.line_items %}--- order.line_items[{{ forloop.index0 }}] ---
name = {{ li.name }}
custom_attributes.size = {{ li.custom_attributes.size }}
{% for p in li.custom_attributes %}ca[{{ forloop.index0 }}] first={{ p.first }} | last={{ p.last }}
{% endfor %} {% endfor %}--- DEBUG END ---
``` For a scanned order, you should see something like: ``` --- order.line_items[0] --- name =...
` tag to anything you'd like. The `{{ scan_id }}` variable is the value that prints, so you can wrap it in any wording your receipt design needs. ### What if I forget to add items to the cart before scanning? The scan still verifies the customer's ID, but the receipt for that sale won't display the scan ID. You can look up the scan in your Real ID dashboard or in the order's note attributes from Shopify admin. If you need help setting this up, [contact us](/contact). --- // File: shopify/pos/upgrading # Upgrading the Real ID POS App When a new version of the Real ID POS extension is released, you may need to update the tile on your Shopify POS device to get the latest features and bug fixes. ## How to upgrade ### Step 1: Open the network menu 1. Open Shopify POS on your device 2. Tap the **Network** icon on the bottom left of the screen ### Step 2: Refresh store data 1. Tap **Store data** 2. Tap **Refresh all** to retrieve the latest version of all Shopify apps connected to your POS The refresh may take some time, but it will indicate when it's finished. ## When to upgrade You should upgrade the POS tile when: - You've been notified of a new Real ID release - You're experiencing issues with the POS scanner - New features have been announced that you'd like to use :::tip If you're still seeing old behavior after following these steps, try force-quitting the Shopify POS app completely and reopening it. ::: --- // File: shopify/pos # Real ID Shopify POS Integration We offer two different ID verification options for Shopify POS. - [ID photo verification](#id-photo-verification) - captures the details of the ID document and stores the images - [ID barcode scanning](#id-barcode-scanning) - uses your Shopify POS barcode scanner to read the details of the U.S. drivers license from the barcode. ## ID barcode scanning U.S. state issued driver's licenses feature a barcode on the back which stores the key information about the license holder. Real ID can read this barcode, extract these details and apply your [minimum age policy](../rules/age-verification.md) as well as check for expiration and validity of the license. ### Getting started First, open your Shopify POS and add a new tile to your home screen:  Then select the **App** option:  Then select the **Real ID** app, and choose the select the _Scan a Drivers License_ tile:  Then at any time before, during or after checkout you can open this tile and scan the back of the customer's drivers license, and it will display the information extracted from the license and automatically check the customer's age and expiration of the ID. ### How to scan drivers licenses with the Shopify POS Opening the **Scan as Drivers License** tile, you'll see a camera view pop up. Simply move the POS camera or barcode scanner to capture the barcode on the back of the drivers license to capture it.  Real ID will then automatically scan the ID's details and check your age restrictions and the expiration of the ID:  :::info Scanning multiple licenses At this time if you need to scan multiple licenses per transaction, you'll need to close the tile and reopen it to start a new ID scan. ::: ### Automatic tagging and metafields When you scan a customer's ID and it passes verification, Real ID can automatically: - Tag the customer with `ID scanned (POS)` - Tag the order with `ID scanned (POS)` - Set metafields on both the customer and order This helps you: - Create automated workflows using Shopify Flow - Track which customers have been ID-verified - Segment customers based on verification status #### Requirements for automatic tagging For automatic tagging to work, you need: 1. **After Checkout flow enabled** - Go to your Real ID settings and turn on the After Checkout flow (no triggers needed) 2. **Customer attached to order** - The POS order must have a customer attached to it 3. **Successful ID scan** - The ID must pass age verification and not be expired ### Limitations Here are the limitations of this ID scanning feature at this time: - ID scanning only supports U.S. issued drivers licenses. - It will not store the actual image of the license itself, it will only capture and store the data extracted from the barcode. - ID scanned data will not display in the Real ID dashboard at this time (coming soon) #### Dual-Barcode Driver's Licenses Some US states (Nevada, Florida, Texas, and others) issue driver's licenses with two barcodes. The smaller barcode can be accidentally scanned instead of the main barcode that contains customer information. See our [guide on scanning dual-barcode licenses](./pos/dual-barcode.mdx) for detailed instructions. #### Camera Scanner Reset Issue If a barcode scan fails due to an incomplete or cut-off barcode, you'll need to close the scanning window and reopen it to try again. This is due to a limitation in Shopify's POS barcode scanner system where the scanner state cannot be reset after a failed scan. When you encounter this issue: 1. Tap the "Close" button 2. Reopen the "Scan Drivers License" tile 3. Try scanning the barcode again For more technical details about this limitation, see the [Shopify community discussion](https://community.shopify.dev/t/scanner-api-state-does-not-reset/976). If you need to store the entire image of the ID, or verify non-US drivers license documents, consider using our [ID photo verification tile instead](#id-photo-verification). ## ID photo verification  Real ID offers an direct POS integration for Shopify merchants. Within your Shopify POS, you can start a new ID check from a tile in your Shopify POS device. Then you can scan the customers ID in real time before or after checkout. ### How does it work The Real ID **Create ID Check** POS tile will open a new browser window on your POS device, then you'll be able to scan the customer's ID and see the results in real time. After scanning the customers ID, simply close the browser window and return to the POS to finish checkout. Real ID will automatically read the first name, last name, date of birth and other details from the ID, and you'll be able to find the ID check from within the app's homepage. :::tip [Your age restrictions](../rules/age-verification.md) and other rules will apply to ID checks from the POS tile. ::: ### Sending an ID check from the POS tile Add a **Link** tile to your Shopify POS to start an ID check in store with one tap. The tile opens the Real ID check page on your POS device, where you capture the customer's ID before, during, or after checkout. #### Get your tile link The easiest way is to copy the ready-made link from the app. In the Real ID admin, open **POS ID Verification** and copy the URL shown there — no typing required. If you'd rather build the link yourself, it follows this pattern: ``` https://admin.shopify.com/store/STORE/apps/realid/shopify/checks/pos/create ``` Replace `STORE` with your store's myshopify subdomain — the part before `.myshopify.com`. For example, a store at `acme-supply.myshopify.com` uses: ``` https://admin.shopify.com/store/acme-supply/apps/realid/shopify/checks/pos/create ``` #### Add the tile First, open your Shopify POS and tap **Add tile**:  1. Choose the **Link** tile type. 2. Paste your link into the tile's **URL** field. 3. Name the tile `Verify Customer's ID`. 4. Tap **Save** to create the tile, then **Save** on the grid to pin it. That's it — tapping **Verify Customer's ID** starts a new ID check and opens the camera so you can capture the customer's ID. :::note If the tile opens the Real ID homepage instead of a new check, your Shopify POS session has expired. Close the Real ID app, then tap the tile again. ::: Need another Real ID tile for your workflow? [Get in touch.](/contact) ### Limitations #### Mobile devices and tablets only At this time, the Real ID **Create ID Check** tile only supports mobile phones and tablets. The Shopify official POS systems do not offer direct camera support at this time. Real ID relies on access to the device's camera to scan the customer's ID. #### Customer and order associations not supported While Real ID automatically reads and assigns the first and last name of the customer from their ID, this integration does not associate with the Shopify customer account nor the order after checkout at this time. This also means that the ID verification tags and metafields will also not update automatically for ID checks created from the POS integration. --- // File: shopify/setting-up-an-order-view # Setting up an ID verification view for your orders in Shopify By default the main **Orders** page in Shopify shows the tags on the far right of the orders table. This can make it difficult to easily see the ID verification status of your orders. But we can quickly create a custom view in Shopify in just a few clicks. Then you'll have a dedicated view to easily see outstanding, passed or failed ID checks at a glance.  ## Creating a **ID checks** view First, open your Shopify dashboard and open the **Orders** page:  At the top of the page, you should see a Plus icon. Clicking on it will create a new **View**:  This should open a pop up to name your new orders view. We recommend giving it a name like **ID checks**:  Then click **Create view** and you'll have a new view to customize separately from your other order views. ## Only including ID verified orders based on tags Now that you have a separate view you can now apply a filter to this view to only show orders that are in a specific status. Click on the filter icon in the main search bar:  Then and paste this into the search to only include automatically verified orders _and_ ID checks approved by your staff: ``` "ID verification completed" OR "ID check manually approved" ``` :::note Quotes required The quotes (`"`) in the above example are required for this filter to work properly. :::  Then click **Save** in the top right to save the filter so this view will only show ID verified orders.  ## Modifying the columns order Now you have a separate view that you can modify the placement of the **Tags** column, which is [how Real ID syncs ID verification statuses to your Shopify dashboard](./tags.md). At the top of the page, click your new **ID checks** view to open a dropdown menu. Then click **Modify columns** to begin customizing the layout of this view:  Now you should see the columns of the **Orders** table are now editable. The **Tags** column by default should be on the far right side:  Simply drag and drop the **Tags** column further to the left so it's more prevalent on your screen:  You can also hide other columns by clicking the eye shaped icon on that column. When you're done making your changes to the **ID checks** view, click **Save** in the top right hand corner to save your changes:  That's it! Now you'll be able to quickly switch between the normal views like **Opened**, **Unfulfilled** and easily switch to **ID checks**. --- // File: shopify/tags # Tags To keep you updated with the latest changes on ID verifications, Real ID synchronizes the ID check statuses of customers & orders in [Shopify with _tags_](https://help.shopify.com/en/manual/shopify-admin/productivity-tools/using-tags). These tags are visible in your orders as well as on the customer profiles within the Shopify backend.  :::info Real ID won't affect other tags Real ID will only change tags related to ID verification. Other tags on your orders and customers will _not_ by removed or overwritten by ID verification related tags. ::: ## How it works ```mermaid flowchart TD id_check_delivered([ID verification required]) -- Customer submits ID photos--> id_check_passed([ID verification completed]) id_check_delivered -- Customer fails ID check --> id_check_failed([ID verification failed]) id_check_failed -. Staff member overrides results .-> id_check_manually_approved([ID check manually approved]) id_check_passed -. Staff member overrides results .-> id_check_manually_rejected([ID check manually rejected]) ``` When an order qualifies for an ID check through your automatic triggers, it will be tagged with `ID verification required`. Then, when the customer passes ID verification, it will change to `ID verification completed`. However, if the customer fails ID verification, the order & customer's profile will be changed to `ID verification failed`. :::tip These tags will apply to both the _customer_ and the _order_ within Shopify. The customer tags are used for remembering repeat customers so they only need to verify once. ::: ## Available Tags Real ID uses the following tags to sync the ID check status: - `ID verification required` - The order or customer requires ID verification - `ID verification completed` - The customer passed the ID check - `ID verification failed` - The customer submitted their photos required for the ID check, but the system was not able verify them - `ID check manually approved` - A staff member manually approved the ID check - `ID check manually rejected` - A staff member manually rejected the ID check - `ID expired` - The ID was valid at the time of verification, but now it is now expired ## Custom tags You can customize the names of the tags Real ID leaves on orders & customers during the ID verification process. To customize these tags, open the **Settings** page, then open the **Notifications** area, and click the **For your Team** tab.  Then you can customize the tag to your choosing. In this example, the tags have been shortened to `ID passed` instead of `ID check completed`:  :::tip Any changes to tags will **not** apply to past ID checks. It will only apply to new orders and customers after the changes are made. ::: ## Limitations on tags Tags are a useful feature for viewing a customer & order's ID check status at a glance from the Shopify Dashboard. However, Real ID cannot guarantee that tags are 1:1 exactly with the ID verification status of an order or customer because: - Real ID tags can be altered by any other app - Real ID tags can be altered via the Shopify dashboard by any staff with orders access - Real ID tags can by altered by Shopify Flows, Zapier, Make, Mechanic or any other automation tool connected to your store If it is critical for your business to hold orders based on ID verification, please consider our [Webhooks feature](../api/webhooks.mdx) for automating actions to your fulfillment system. --- // File: theming/branding # Branding ID checks You can use your own brand within ID checks, and your brand will not only extend to the ID check flow but also to emails sent to customers. Your theme settings for Real ID can be found within the **Appearance** section with the app **Settings**:  ## Uploading your Logo At the bottom of the **Branding** section, you'll be able to upload your own logo:  Here you can drag and drop your logo, or alternatively you can click on the dashed box to open a file browser to find and select a file. :::note Your logo will be automatically resized in order to make it responsive on mobile, tablet and desktop views. There's not need to resize the image before uploading. ::: ## Theming You can design the Real ID theme to match your store's theme. Within the **Branding** settings, you can set the **Primary** and **Button** colors of the theme. ### Primary color The **Primary color** is applied to the background of the ID checks, in both emails as well as the ID check flow.  :::tip We recommend using a neutral color for the primary color, like a light gray. This helps make the **Start ID verification** button more visible to the customer. ::: ### Button color The **Button color** is applied to the background of the call to action buttons to start the ID check, as well as buttons within the ID check flow. :::tip We recommend using a darker color for the button color. The font color of the button is white by default and a darker color will add more contrast to make the button more visible and readable. ::: --- // File: theming/customize-content # Customizing ID check content You can customize the content within Real ID, including the content shown within the ID check flow as well as the emails sent to customers during the ID check lifecycle. ## Choosing the default language Real ID allows customers to change the translation of the ID check prompts within the flow. However you can set the initial default language within the **Appearance** section of the **Settings** page. Real ID currently includes translations for the following languages: * English * Spanish * German * French * Korean If you need additional languages supported - [please contact us](mailto:support@getverdict.com). ## Customizing Emails During the ID check lifecycle, Real ID will send email notifications to the customer at each step along the way. * `Introduction` - the first email sent to the customer, explaining why they're being sent an ID check. * `In Review` - sent if the customer's ID wasn't able to be automatically verified because of bad image quality, missing fields, an expired ID or any other failed reason. * `Verified` - sent if the customer's ID was able to be automatically verified _or_ if their [ID check is manually approved by one of your staff](../for-merchants/overridding-results.md). * `Failed` - only sent if the [ID check is manually rejected by your staff](../for-merchants/overridding-results.md) in the Real ID dashboard The content of these email notifications are customizable in the **Appearance** area of the **Settings** page within the app:  Then you'll be able to choose between email templates options and edit the content:  As you type, you'll see a preview of the email within the **Preview** on the right side. ### Shortcodes To personalize the message, use shortcodes to reference the customer's name and order number. * `[orderId]` - The unique order ID number * `[firstName]` - The customers first name * `[lastName]` - The customers last name :::tip As a best practice, we recommend including the customer's name and order number within the message. This helps customers recognize that this ID check is related to their order. ::: ### Best practices The **Introduction** email is the most important email template. It should clearly communicate: * Why the customer needs to complete ID verification * That ID verification is secure and convienent * What happens when they finish their ID check If you require ID verification as part of your K.Y.C. compliance needs, or for age verification purposes, then you should communicate that as well. ### Disabling customer emails At this time you can optionally disable the **In Review** email. The **In Review** email is sent when the customer fails automatic ID verification, but has not been manually rejected or manually approved. You can choose to disable this email if you'd like. If this option is enabled, then customers will _not_ receive an email if they fail ID verification. ## Customizing SMS messages Due to phone carrier restrictions for content sent via SMS messages, the ID verification notice message is not editable. However, the default includes the order number and customer name, as well as the unique ID check link that allows customers to complete ID verification. [Learn more about how Real ID sends SMS messages](./sms). --- // File: theming/sms # SMS messages For ID checks sent after checkout automatically Real ID can also send an SMS message to the customer if their phone number is provided in the order. The SMS message will include a unique link for the ID check, the same as the email sent to customers. ## SMS Content Unfortunately due to restrictions placed by phone carriers, we cannot allow the customization of SMS messages. ## From phone number All ID checks sent via SMS will come from a phone number managed by Real ID: * `+1 (884) 997-2426` If the customer's phone number is registered in a country that supports Alpha codes, they will receive an SMS message from `Real ID`. ### Activate the phone number checkout field on Shopify To set up phone number collection from customers during checkout, open your Shopify **Settings** and then open the **Checkout** section:  Then scroll down to the **Customer information* section, and choose an option under the **Shipping address phone number** options:  You can require phone numbers or make them optional. If any order triggers an ID check and the customer provides their phone number for shipment, then Real ID will use this phone number to send the customer a link to their ID check. ## Frequently asked questions ### If I send an ID check manually, will an SMS message still be sent to the customer? Yes, as long as the customer's phone number field is entered while creating the ID check. ### I'm seeing an error that the SMS message failed to send, why is that? The most common reason why an SMS message fails to send is because the phone number on the order is not valid or belongs to a landline. In these scenarios it's not possible to send an SMS message to the customer. ### Are SMS messages an additional cost? No, SMS messages are not any additional cost to the ID check fee. --- // File: theming/white-label-domains --- // File: theming/your-email-address # Using your own email address Build trust with your customers that the ID check sent to their email address is associated with your store by using your own dedicated support email address. For example, Real ID can use your dedicated support email address like `support@yourstore.com` to send ID checks to customers. You can easily add your own email address to Real ID without making any code changes or changes to your DNS settings. We just send a confirmation link to your email address, after clicking it ID checks will be sent from your email address. ## Getting Started To get started, first open up Real ID and navigate to **Settings**. Once you have your settings open, select the **Notifications** tab, and make sure you're within the **For Customers** section to see your email settings for customers.  Scroll to the **Send ID checks using your email address section**. Here you can enter in the preferred name and email address you'd like to use to send ID checks. After entering in your preferred email address & name, click **Verify**.  You will receive an email to that address from Postmark which is our email provider. Within that email will be a link to confirm your ownership of that account. :::note It may take a few minutes for the verification email to appear. If it's still not in your inbox, check your spam folder. If you're still having issues finding the email, [please contact us](mailto:support@getverdict.com). ::: Click the confirmation link and your will prove ownership of the account. Last step, return to Real ID and click the "Check verification status" button. Real ID will now send emails to your customers using your own email address! :tada: :::warning You cannot use public email domains like `gmail.com`, `hotmail.com` or `outlook.com` with this feature. It is not possible for us to verify these domains, you'll need to use a privately owned domain. ::: ### Verifying DKIM Records For best results, we highly recommend adding DKIM DNS records that help improve the reliability of your emails. After you've verified ownership of the email address, two DNS records will appear beneath the same **Use your email address** section in the **Notifications** settings:  Click each record's `Host` and `Value` fields to automatically copy them to your clipboard, and paste them into new DNS records. After you've added the DKIM and Return Path DNS records, click the **Verify** button within the Real ID app to verify the new DNS records. Then your DNS records will be verified and this will ensure the best deliverability for your ID checks to customers.  :::note It may take up to 72 hours for DNS records to change. If your DNS records fail to verify after checking for typos, missing characters, or extra spaces, then please try again later. ::: ## Frequently Asked Questions ### This feature is locked on my account. How can I enable it? This feature is for Business plan subscribers. Upgrading your subscription to Business will unlock the feature. If you need help doing this please contact us. ### I'm getting an error when trying to submit my email Please note: we can only use private email domains. Public domains like gmail.com, hotmail.com, or apple.com are not supported. If you're using a non-public email and are still having issues, please contact us for support. ### Our Real ID customer emails are being sent to spam If you haven't yet, [set up DKIM DNS records on your domain](#verifying-dkim-records). This helps improve the trust for email providers like Gmail, Yahoo and Outlook. --- // File: triggers/all-orders # Check all orders Enabling **Check all orders** will automatically trigger ID verification on all orders. This is especially helpful if you're selling age restricted products, or require ID verification for K.Y.C. purposes. To enable this trigger, open the **Automations** section of the **Settings** page, enable automatic ID checks, and toggle on **Check all orders**. --- // File: triggers/high-value-orders # High value orders You can require ID verification for all orders above a specific total order price. This is especially helpful for verifying high chargeback risk orders. When you enable this trigger, also set the threshold for total order value (including tax) that should trigger an ID check.  :::note At this time the threshold setting is denominated in U.S. dollars, regardless of the currency you have set for your store. ::: --- // File: triggers/address-mismatch # Mismatching billing to shipping details When an order's payment details like the name and address on the payment don't match the name and address on the shipping details, it _could_ be a sign of potential fraud. Real ID can help save sales and prevent chargebacks by requiring ID verification on these orders. If the ID matches the billing details, then you have evidence to prove the customer is the true holder of the credit card.  :::note Within Shopify, this trigger is based off of the [`shippingAddressMatchesBillingAddress`](https://shopify.dev/docs/api/admin-graphql/2023-04/objects/order#field-order-billingaddressmatchesshippingaddress) attribute on the order via the Shopify Admin GraphQL. ::: --- // File: triggers/high-risk # High risk level :::note Shopify only This trigger relies on Shopify's built-in fraud analysis and is only available on Shopify stores. ::: Shopify provides [fraud analysis for all orders](https://help.shopify.com/en/manual/orders/fraud-analysis) when using Shopify Payments as your payment gateway. You can trigger ID checks on orders that have `Medium` or `High` risk based on Shopify's analysis, or any other 3rd party apps that detect potential fraud based on order and customer details.  Please note, that fraud analysis results are not always completed at the same time the order is considered placed. It can take up to several minutes for the fraud analysis to complete. Real ID will automatically retry retrieving the latest risk analysis 5 minutes after it receives the order initially. :::tip Other 3rd party fraud detection apps that add risk analysis to the order in this format are also compatible with this trigger. ::: --- // File: triggers/specific-products import Tabs from "@theme/Tabs"; import TabItem from "@theme/TabItem"; # Specific products You may only require ID verification for an order if the order contains one or more specific products.