Civic FAQs

Use your Civic Secure ID to safely access partner websites and services using the Civic Secure Identity app.

How does it work?

The Civic Secure Identity app stores your sensitive information securely on your phone using bank-level encryption and biometric locks. By keeping your data in your control, it's much harder for hackers and other malicious groups to gain access to this information.

Civic Partners request your information through custom QR codes that you scan with the Civic Secure Identity app. Once you've unlocked the app with your biometrics, you can scan the QR code, review exactly what information is being requested, and choose whether to approve or deny the request.

This unique method allows members to create secure accounts, login to existing accounts, and share sensitive information all without passwords or data being stored outside of your mobile device.

What is Civic Secure ID backup?

The Civic app securely backs up to your iCloud or Google Drive account, allowing you to retain access to your identity even if you delete and reinstall Civic. This works across devices on the same operating system. Since every persons identity is unique, you will not be able to set up another new Civic Secure ID.

How do I restore or transfer my Civic Secure ID backup?

Accounts can only be transferred to a new device if they are backed up to the same iCloud or Google Drive account. This means that you will only be able to transfer accounts onto devices with the same operating system.

We recommend that you transfer your account in order to retain access to previously authorized partner services.

If you have an iPhone and have enabled iCloud backup on both old and new devices, or have an Android phone and have enabled Google Drive Backups on both devices:

Download the Civic app on your new device and open it.

If a backup is found, the Civic app will prompt you to restore your Civic data. Tap Restore Civic ID.*

* If you are migrating to a different operating system (e.g. Google to Apple), you will need to reset your account and register again. *

Please note that after your account has been reset, you may lose access to previous logins for all partner authorized apps and sites until you successfully verify the same identity information.

We recommend that users restore their Civic Secure ID from backup. If you are having issues restoring your account please follow these troubleshooting steps:

Account Reset Instructions:

If you are unable to recover from a backup please email [email protected] from the email needing to be reset.

Include the telephone number (must include country code) and email address you previously used to sign up with. Your request must originate from the same email address provided. Our standard response time is 24-48 hours.

Once the account has been reset, please delete and reinstall the Civic app on your device.

Launch the Civic app. If prompted, please do not restore from backup.

Complete the Civic ID registration.

Ensure that backup is enabled for your Civic ID.

How do I check that that same iCloud or Google Drive Backup account is being used?

iPhone Users:

Check that the same iCloud account your Civic ID is backed up to is enabled on your new device:

Tap Settings > [your name] > iCloud.

Tap iCloud Drive.

Make sure iCloud Drive is on.

Make sure your backup account is the same as before.

Restart the Civic app and click on restore backup.

If this fails, you will need to register a new Civic ID. Please submit a request for an account reset.

Android Users:

Check that the same Google Drive backup account is enabled on both your devices settings:

Go to Settings on your device.

Find Backup & Reset, or, System > Backup.

Make sure your backup account is the same as before.

Make sure Backup to Google Drive is on.

Restart the Civic app and click on restore backup.

If this fails, you will need to register a new Civic ID. Please submit a request for an account reset.

* Android only: Auto backup occurs roughly every night and when all below conditions are met:

Minimum version Android 6.0.

Backup is enabled on the device in Settings > Backup & Reset.

At least 24 hours have elapsed since the last backup.

The device is idle and charging.

The device is connected to a Wi-Fi network. If the device never connects to a wifi network then Auto Backup never occurs.

A valid passport,driver's license,or government-issued/National ID. For a full list of document types by country, please see our coverage map.

The document must contain all of the following:

Full name

Photo

Date of birth

Document expiry date

Document number

Please ensure that your document scan is clear and legible. Your document needs to:

Use good light on a flat, solid surface.

Check that no details are obscured by objects or glare.

Include all document borders

If your scan is not clear or legible, please modify your lighting conditions and rotate the document then rescan as needed.

Email Verification:

Make sure you are connected to the internet. If you are using wifi, please make sure that communication is not restricted by VPN or firewall.

Search for emails from [email protected].

Make sure you are checking the same email account as the one you used to register.

SMS Verification:

Make sure you are connected to your wireless service.If you are using wifi, please make sure that communication is not restricted by VPN or firewall.

Please check that you have entered the correct Country Code and Phone Number.

If, after uploading your scans, you receive an error saying We had trouble verifying you, then please follow the troubleshooting steps below.

Review and rescan your documents before retrying verification. These are some possible reasons for failure:

The document may be partially covered. Make sure that no part of the document is cut off, cropped or obscured (by your fingers, glare, etc.).

Image quality may be too low. Use a plain background, good light, and a flat surface when you scan. Ensure high contrast with the background. Aim the camera straight, and ensure that the scan is not blurred. Make sure the camera is not too close to document and attempt to reorient document 90 degrees for the scan.

The document may be expired. Please check that your document is still valid before you upload it.

Your details may not match. Please check that you have entered your name and address correctly on the website.

It may be a document type that we can not accept. For a full list of acceptable documents by country,please see our coverage map here.

The Civic app is available on iOS and Android. Download from the iTunes Store or get it on Google Play.

Once you have downloaded the Civic app, you will need to set up your Civic Secure ID:

When you open the app you will be asked to create a secure sign-in such as using the phone's Fingerprint/FaceID or a passcode.

You will be asked to enter and verify both your phone number and email address.

A five-digit verification code will be sent via SMS and email respectively.

Once both have been verified, you can begin using your app to authenticate into our partners services.

It is not currently possible to edit verified information on your existing Civic Secure ID. To associate a new phone number or email with your Civic Secure ID, please submit a request for an account reset.

Once this is complete, you can create a new Civic Secure ID with the new phone number or email.

However, creating a new Civic Secure ID is not recommended, since you will need to reverify all previous identity details and you may lose access to previously authorized apps and sites.

Civic leverages trusted 3rd parties in the Identity.com Marketplace to validate personal information with blockchain attestations and stores everything locally on the users mobile device.

This is a thorough verification process and in some cases take more time. While we verify your data, feel free to exit the app and we will notify you via email of the status of your verification. You can also check back in your app for next steps.

What is Civic Secure ID backup?

The Civic app securely backs up to your iCloud or Google Drive account. This enables you to retain access to your identity if you delete and reinstall Civic - even across devices! Since every persons identity is unique, you will not be able to set up another, new Civic Secure ID. If no backup is found upon reinstall, you will need to reset your account.

Please note that after your account has been reset, you may lose access to previous logins for all partner authorized apps and sites until you successfully verify the same identity information.

Enabling backup on iPhone:

Goto Settings > [your name] > iCloud.

Select iCloud Drive.

Make sure iCloud Drive is on.

Enabling backup on Android:

Go to Settings.

Find Backup & Reset, or, System > Backup.

Make sure your backup account is the same as before.

Make sure Backup to Google Drive or "Backup to iCloud" is on.*

Enabling backup in the Civic app

Launch Civic ap and click on the Profile icon

2. Click on the Widget icon

3. Ensure "Backups Enabled" is on

* Android only:Auto backup occurs roughly every night and when ALL below conditions are met:

Minimum version Android 6.0.

Backup is enabled on the device in Settings > Backup & Reset.

At least 24 hours have elapsed since the last backup.

The device is idle and charging.

The device is connected to a Wi-Fi network. If the device is neverconnected to a wifi network, then Auto Backup never occurs.

This error appears when there are connectivity issues when requesting a verification code for email or phone number.

Please make sure that you have internet connectivity. If you are using wifi, please make sure that there are no VPN or firewalls blocking communications. If you are unsure, please disable your wifi, and use your mobile network. Please ensure that you have a strong signal.

If the issue persists, please email [email protected] and include the following information:

Mobile device

Operating System

App Version

Screenshot of the error from your mobile device

To setup a Civic Integration Portal account:

You must have a verified Civic ID to log into the Civic Integration portal. To setup a Civic ID please follow this article.

Once you have a Civic ID, open the Civic Integration Portal and click on the Connect button.

create your apps.

Scan the QR code using your Civic Secure Identity mobile app.

Click authorize from the mobile app to authenticate.

Fill in your company information.

Use your primary email address. This email will receive all notifications regarding your account.

Follow this guide on inviting your team to the Integration Portal.

You are set up your company profile and

The Civic Secure Identity app stores your sensitive information securely on your phone using bank-level encryption and biometric locks. By keeping your data in your control, it's much harder for hackers and other malicious groups to gain access to this information.

Civic Partners request your information through custom QR codes to be scanned with the Civic Secure Identity app. Once you've unlocked the app with your biometrics, you can scan these codes, review exactly which information is being requested, and choose whether to approve or deny the request.

This unique method allows members to create secure accounts, login to existing accounts, and share sensitive information all without passwords or data being stored outside of your mobile device.Use your Civic Secure ID to safely access partner websites and services using the Civic Secure Identity app.

Want to see Civic in action? Head to WikiHow and click "Login with Civic"!

Sign into the Integration Portal. If you do not have an account, please register.

Create an app in the Civic Integration Portal.

Generate API Keys.

Enter keys into your app.

How do I integrate Civic into my Wordpress account?

Tip: Don't forget to save your private API keys somewhere safe!

Are you on Wordpress? Check out

If you scan your QR code and the browser returns an Error 401 (Unauthorized) it is important for the administrator to check the whitelisted domains in the Integration Portal.

Please check that you have whitelisted all applicable domains used by your app to host login. Please also make sure that the correct protocols are included, ie. secure (https://) and non-secure domains (http://). In order for Civic app to function properly, we need to know which URLs to enable traffic to.To check and update your whitelisted domains please follow these steps:

Log into the Integration Portal

Click Applications in the left sidebar

Choose the application to update

ClickEdit in the upper right

Update your Whitelisted Domains; separate these with a comma

Scroll down and click Save Changes

Re-test the flow to your application

http://localhost:4000

Tip:Make sure to include any localhost or staging server domains

Tip:If you are still receiving the 401 error then please add the port numbers, ie:

Still need help? Please contact us at [email protected]

Civic Secure Identity Platform is an open-source software platform that allows users to securely log in and register for your site. To get started, you will need to register with the Civic app and then use the app to log into the Integration Portal to obtain your App ID and API keys.

For full instructions, please visit our Wordpress Plugin Page.

You will receive an email update with your status within 4 business days. Once approved, you may authenticate into partner services by scanning their QR code with your Civic app.

Please refer to our API docs for full Civic Secure Identity integration instructions.

Here are the links to Civic authored server-side libraries:

nodeJS

.NET

Ruby (basic only)

Here are links to available open source libraries:

Java

PHP (basic only)

In order for Civic app to function properly, we need to know which URLs to enable traffic to.

Please also make sure that the correct protocols are included, ie. secure (https://) and non-secure domains (http://). In order for Civic app to function properly, we need to know which URLs to enable traffic to.

To configure your Whitelist Domains

Log into the Integration Portal

Go to Applications.

Select your app.

Click Edit and enter as many website addresses as you would like, separated by commas. Ie. https://www.yoursite.com, https://app.yoursite.com, https://es.yoursite.com. Include protocol, e.g https://

You are able to revoke your current set of keys while keeping them active for as long as you specify below. This will assist you in transitioning between your current and new keys. Both sets of keys will be temporarily active - up to your current sets' specified time-to-live (TTL), after which we will permanently switch over to your new keys.

To get new keys:

1. Log into the Integration Portal

2. Click Revoke & Regenerate Keys.

generate new API keys

3. Specify a time-to-live (TTL) on your current set of keys before they are invalidated then clickRevoke Key

You will be able to select from these options:

Immediate

1 Hour

6 Hours

12 Hours

24 Hours

1 Week

Now go .

We understand that developer teams are larger and require more than one person to have access to the Civic Integration Portal, so we have created the Team Management feature, where multiple developers can work on the same Company and on the same Application. The Team Management feature can be accessed from Civic Integration Portal's menu.

Inviting A New Team Member

How to invite a new team member:

Log into the Integration Portal

Click Team

Type in their e-mail address, choose their role and click invite

Integrate Portal permission levels

If attempting to invite a user with an existing Integration Portal account, the user must submit a request to unlink their Civic Secure ID and Integration Portal account. Please include the Civic Secure ID email and phone number. Once unlinked, they can be added to a team.

User Roles

There are three different permission levels: Adminand Dev.

Admin

Admins have full access to modify and deploy at the Company and Application level. As an account Admin on the Civic Integration Portal, you have full control over:

Team Membership and Roles

Company information & Primary Contact information

Applications in Test and Live Modes, conversion from one mode to the other

Dev

Developers are team members that have the rights to access and integrate Test Mode applications and work with Administrators to push Applications to Live Mode.

They can request Application upgrades from Test Mode to Live Mode, butcan'tmove an application to Live Mode on their own. Developers also cannot modify Company or Contact information.

Learn more about the .

Our Integration Portal offers a Team Management feature allowing multiple developers to work on the same Company and on the same Application.

The first person to register their Company and domain is by default the team owner. The Team feature is located within the Integration Portal.

That person can then invite other team members.

Teams using the Civic SIP integration can be split into two categories, with different permission levels, reflected in the Roles Chart. Please see full description below:

Admin: Admins have full access to modify and deploy at the Company and Application level. They can also extend Admin access to others.

Dev: Have the rights to access and integrate Test Mode applications and work with Administrators to push Applications to Live Mode.They can request Application upgrades from Test Mode to Live Mode, butcan'tmove an application to Live Mode on their own. Developers also cannot modify Company or Contact information.

Attention!Once a Dev team member decides to leave, they will cease to have access to the Company account and will have to be re-invited by an admin.

After scanning the QR code on the partner's site, please revert back to your Civic app and approve the partners authorization request inside your Civic app.

If the request on the partner's site or app times out, please scan the QR code again and authorize the app.

Civic's securely encrypted backup allows you to retain access to your identity if you delete and reinstall the Civic app. This works across devices. Your Civic backup is stored locally on your device. To remove your Civic ID first, delete your Civic backup, then, uninstall the Civic app.

Delete your iCloud backup

Delete your Android backup

*Warning: removing the backup will remove access to all previously authorized partner services.

Generate API Keys

IMPORTANT: Once generated you will need to copy and store your private keys as they will not be available again (WE DO NOT STORE YOUR API KEYS).

New applications default to test mode. Your newly generated keys will work immediately.

Note: While in test mode your users will see a "test mode" banner.

API Keys can be regenerated or removed at any time.

2. Request Upgrade

Once requested, the Request Button will change to "In Review" and we will review your account to approve for production use.

We may contact you if necessary via the provided contact information during the approval process.

Please allow 2-3 business days for the approval process to be completed.

3. Go Live

Once you have been approved, click the Go Live button to switch your application to production mode.

Production mode removes all test mode indicators and banners.

Sign into Integration Portal. If you do not have an account, please register.

Click Add Application.

Enter app name, domains to be whitelisted, and upload logo.

Please check that you have whitelisted all applicable domains used by your app to host login. Please also make sure that the correct protocols are included, ie. secure (https://) and non-secure domains (http://). In order for Civic app to function properly, we need to know which URLs to enable traffic to.To configure your Whitelist Domains:

Go to Applications.

Select your app.

Click Edit and enter as many website addresses as you would like, separated by commas.

What is KYC?

Civic Reusable KYC (Know Your Customer) is the blockchain-based tool for organizations that require more than basic account verification services. Our global KYC application enhances basic account verification services (mobile number and email verification) with scanning and document verification, such as passport and drivers license, and Accredited Investor Checks using the Civic Mobile App.

How does it work?

Identity verification is a voluntary information exchange between the User and the Requester. The Civic Secure Identity Platform (SIP) stores and shares Authenticated Data only with the User's permission, while the Civic Marketplace is a decentralized environment where CVCs are used for attestation payments. An individual downloads the Civic App, establishes an account, and, upon signing up for Requester services, they verify their identity on the blockchain and share the Authenticated Data with Requesters.

How do I request KYC access?

From the Integration Portal :

Sign in to the Integration Portal or Register for a Civic Integration Portal account.

From the side menu, click KYC.

Request access to KYC using the Request button.

here

Please allow a few business days for review. The primary owner will be notified via email.

To activate this feature on your Civic implementation, please update the scope request parameter from BASIC_SIGNUP to PROOF_OF_IDENTITY.

If you are interested in learning more but do not have an Integration Portal, please submit an inquiry .

All applications created within the Integration Portal must contain a logo that will be displayed in the Civic app when a user is required to share data with the partner service. When setting up a new application or editing existing app, please upload a logo into the logo field. A preview will be generated to show how the logo will be displayed within the Civic app.

In addition to using a logo that can be identified with the app/company, please ensure that the image meets therequirements listed below:

Format: PNG or JPG format (preferably PNG with transparency).

Minimum Height: 150px.

Maximum File Size: 1Mb.

The image must not contain additional text (like tag lines) or graphics.

Do not include margins or whitespace - the logo should fill the image.

Backgrounds should be transparent or pure white.

Note that the logo will be displayed on a white background.

Logo shouldnt be white (unless a coloured background is included for contrast).

Ensure the logo is of high quality and not fuzzy.

Upgrading app from test to production mode will remove the test banner at the top of QR code. Follow these instructions to request app promotion.

From your app within Integration Portal, click 'Request Upgrade'.*

Once requested, we will review your account to approve for production use.

We may contact you if necessary via the provided contact information during the approval process.

Allow 2-3 business days for the approval process to be completed.

*Do not see Request Upgrade button? Make sure you have Generated API keys.

Create app.

Click Generate Keys Now.

Copy these private keys to a safe and secret place. [Private Signing Key, Secret, and Private Encryption Key will only be shown once.]

Click Done Managing Keys.