> ## Documentation Index
> Fetch the complete documentation index at: https://docs.seam.co/llms.txt
> Use this file to discover all available pages before exploring further.

# ASSA ABLOY Vingcard Credential Services Setup Guide

> Connect your ASSA ABLOY Credential Services to Seam.

## Overview

This guide walks you through connecting ASSA ABLOY Credential Services to Seam. You must already have an ASSA ABLOY Credential Services account before proceeding.

To obtain an account, register for the ASSA ABLOY partnership program by sending an email to either of the following addresses:

* [mobile.access.globalsolutions@assaabloy.com](mailto:mobile.access.globalsolutions@assaabloy.com)
* [onboardingprogram@assaabloy.com](mailto:onboardingprogram@assaabloy.com)

***

## Before You Begin

Before connecting your ASSA ABLOY Credential Services to Seam, you must first identify your ASSA ABLOY credentials.

While you are in the development phase of your application, you can find your [development credentials](#retrieve-your-assa-abloy-development-credentials) in the ASSA ABLOY Global Solutions Technology Partner Portal. You cannot use this preliminary application ID to connect to live sites.

Once you have received certification through the ASSA ABLOY partnership program, ASSA ABLOY provides a set of [production credentials](#retrieve-your-assa-abloy-production-credentials).

### Retrieve Your ASSA ABLOY Development Credentials

Locate your ASSA ABLOY tenant account username and password, as well as your Visionline system ID, application ID, and credential services URL in the ASSA ABLOY Global Solutions Technology Partner Portal.

1. In a web browser, go to the [ASSA ABLOY Global Solutions Technology Partner Portal](https://my.assaabloyglobalsolutions.com/tpp).

2. Log in to the ASSA ABLOY Global Solutions Technology Partner Portal.

3. Click **Accounts > Account List**.

   <img src="https://mintcdn.com/seam/3MkQAe40a-b0KYcA/images/assa-abloy-accounts-account-list-menu-item.png?fit=max&auto=format&n=3MkQAe40a-b0KYcA&q=85&s=3cce25ba865cbb00010ba0838875b0fe" alt="In the ASSA ABLOY Global Solutions Technology Partner Portal, click Accounts > Account List." style={{width: "430px", height: "auto"}} data-og-width="869" width="869" data-og-height="200" height="200" data-path="images/assa-abloy-accounts-account-list-menu-item.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/seam/3MkQAe40a-b0KYcA/images/assa-abloy-accounts-account-list-menu-item.png?w=280&fit=max&auto=format&n=3MkQAe40a-b0KYcA&q=85&s=285e5000da926c4327d20c5bc6184763 280w, https://mintcdn.com/seam/3MkQAe40a-b0KYcA/images/assa-abloy-accounts-account-list-menu-item.png?w=560&fit=max&auto=format&n=3MkQAe40a-b0KYcA&q=85&s=5fa34b5739345531967f1d101da884b2 560w, https://mintcdn.com/seam/3MkQAe40a-b0KYcA/images/assa-abloy-accounts-account-list-menu-item.png?w=840&fit=max&auto=format&n=3MkQAe40a-b0KYcA&q=85&s=ce3a1ec141d92db1655d084735b45412 840w, https://mintcdn.com/seam/3MkQAe40a-b0KYcA/images/assa-abloy-accounts-account-list-menu-item.png?w=1100&fit=max&auto=format&n=3MkQAe40a-b0KYcA&q=85&s=2929ccf4593e4cd544424e3e1a30811a 1100w, https://mintcdn.com/seam/3MkQAe40a-b0KYcA/images/assa-abloy-accounts-account-list-menu-item.png?w=1650&fit=max&auto=format&n=3MkQAe40a-b0KYcA&q=85&s=6c1ebf58829659d05aa8e7328ec18d5f 1650w, https://mintcdn.com/seam/3MkQAe40a-b0KYcA/images/assa-abloy-accounts-account-list-menu-item.png?w=2500&fit=max&auto=format&n=3MkQAe40a-b0KYcA&q=85&s=f86aa9715478929e3db9cea1c3f92931 2500w" />

4. In the **Agreements** area, locate and open the text (`.txt`) file. This text file contains your ASSA ABLOY tenant account username and password, as well as your Visionline system ID, application ID, and credential services URL.

### Retrieve Your ASSA ABLOY Production Credentials

Once you have received certification, ASSA ABLOY provides your production credentials, including your application ID.

***

## Step 1: Connect Through the Connect Webview

1. Create and then display a [Connect Webview](/core-concepts/connect-webviews), including `assa_abloy_credential_service` in the set of [`accepted_providers`](/api/connect_webviews/object).
2. In the Connect Webview, perform the following steps:
   1. Click **Continue**.

   2. If the Connect Webview displays multiple brand options, select **Assa Abloy Credential Service**.

   3. In the **Username** field, type your tenant account username.

   4. In the **Password** field, type your tenant account password.

   5. In the **Credential Services URL** field, type the credential services URL.

      <img src="https://mintcdn.com/seam/3MkQAe40a-b0KYcA/images/connect-webview-assa-abloy-credential-service-credentials.png?fit=max&auto=format&n=3MkQAe40a-b0KYcA&q=85&s=17691fc983ab39b6fe5bf898c49f8a33" alt="" width="362" height="686" data-path="images/connect-webview-assa-abloy-credential-service-credentials.png" />

   6. Click **Submit**.

***

## Step 2: Configure Your Application ID (Custom Mobile App Only)

If you are developing a custom mobile app, configure your ASSA ABLOY settings:

1. In the top navigation pane of [Seam Console](https://console.seam.co/), click **Settings**.

2. On the **Workspace Settings** page, next to **Assa Abloy Settings**, click **Edit**.

3. In the **Assa Abloy Settings** dialog, type your application ID.

   ASSA ABLOY assigns this application ID to your app when you receive certification. This single application ID uniquely identifies your application within both the iOS and Android app stores.

   <img src="https://mintcdn.com/seam/3MkQAe40a-b0KYcA/images/assa-abloy-settings.png?fit=max&auto=format&n=3MkQAe40a-b0KYcA&q=85&s=06e6c2f02c07685ac9fe7a83893379f2" alt="Type your ASSA ABLOY application ID." style={{width: "400px", height: "auto"}} width="802" height="453" data-path="images/assa-abloy-settings.png" />

4. Click **Save**.

<Info>
  ASSA ABLOY assigns you a preliminary application ID during the development
  phase. You cannot use this preliminary application ID to connect to live
  sites. After you receive certification, ASSA ABLOY provides a production
  application ID that you can use to connect to real sites. Consequently, when
  you obtain certification, you must edit your workspace settings to update this
  application ID.
</Info>

***

## Step 3: Verify the Connection

After connecting, verify that your ASSA ABLOY Credential Services account appears in your Seam workspace and shows a **connected** status.

***

## Troubleshooting

### Connection fails during login

* Verify that you are using the correct tenant account username and password from the ASSA ABLOY Global Solutions Technology Partner Portal.
* Confirm that the credential services URL is entered correctly.

### Cannot connect to live sites

* Ensure you are using production credentials, not development credentials. The preliminary application ID cannot connect to live sites.
* If you have recently received certification, update your application ID in the workspace settings.
