Creating Visionline Card-based Credentials
Learn how to create a card-based credential for Visionline.
To create a credential to encode onto a plastic key card for a Visionline ACS:
Set up an ACS user.
Create a credential with the
access_method
set tocard
and the appropriatevisionline_metadata
, such as the card format.To issue the first credential for a reservation—that is, an "override" credential—make sure to set
visionline_metadata.override
totrue
.To issue subsequent credentials for a reservation, set the
visionline_metadata.joiner_acs_credential_ids
.
For more information about Visionline credential types, see Credential Types for Visionline and Guest Mobile Credential Types.
Encode the credential onto a plastic card.
Use the
/acs/encoders/list
endpoint to retrieve a list of available encoders. Then, choose the encoder that you want to use to write the credential to the card. See Retrieve Encoders.Use the
/acs/encoders/encode_credential
endpoint to encode the credential onto the card, using the encoder that you have chosen. See Encode the Card.Confirm that the card was encoded successfully using polling or a webhook. See Confirm Successful Encoding. Also, see a list of common encoding errors.
The following example shows how to create a card-based override credential for Visionline and encode it onto a plastic card:
Code:
# Step 1:
# Create the new ACS user.
acs_user = seam.acs.users.create(
acs_system_id = "11111111-1111-1111-1111-111111111111",
full_name = "Jane Doe",
email_address = "[email protected]"
)
# Step 2:
# Create a card-based credential for each entrance for the ACS user.
credential = seam.acs.credentials.create(
acs_user_id = acs_user.acs_user_id,
access_method = "card",
# List the IDs of the entrances to which
# you want to grant access.
allowed_acs_entrance_ids = [
room_101.seam_acs_entrance_id
],
starts_at = "2024-12-01T15:00:00.000Z",
ends_at = "2024-12-04T12:00:00.000Z",
visionline_metadata = {
"card_format": "rfid48",
"override": True
}
)
# Step 3:
# Encode the credential onto a card.
# First, get the encoder that you want to use.
encoder = seam.acs.encoders.list(
acs_system_ids = ["11111111-1111-1111-1111-111111111111"]
)[0]
# Then, encode the card.
encoding_action_attempt = seam.acs.encoders.encode_credential(
acs_credential_id = credential.acs_credential_id,
acs_encoder_id = encoder.acs_encoder_id
)
# To confirm that the encoding succeeded,
# poll the returned action attempt
# until its status is success.
seam.action_attempts.get(
action_attempt_id = encoding_action_attempt.action_attempt_id
)
Output:
AcsCredential(
acs_credential_id='66666666-6666-6666-6666-666666666666',
acs_user_id='33333333-3333-3333-3333-333333333333',
access_method='card',
starts_at='2024-12-01T15:00:00.000Z',
ends_at='2024-12-04T12:00:00.000Z',
is_issued=False,
...
)
ActionAttempt(
status='success',
action_attempt_id='11111111-2222-3333-4444-555555555555',
action_type='ENCODE_CREDENTIAL',
result={
acs_credential_id='66666666-6666-6666-6666-666666666666',
card_number='1234abc',
is_issued=True,
issued_at='2024-12-01T12:00:00.000Z',
...
},
error=null
)
Next Steps
You can use an encoder to scan a plastic key card to read its encoded parameters. The scan result includes the card's properties, such as its card number, serial number, and other useful details. For more information, see Scanning Encoded Cards.
Last updated
Was this helpful?