Bulk Enrollment

If you already have a set of cards that you want to enroll in Network Tokens, you may consider backbook/bulk enrollment. You will need to submit a .csv file with the required set of headers in the file, and VGS will take care of all other steps for you.

Prerequisites

  • You must have valid VGS aliases that point to the PAN of the cards from a production vault on your VGS dashboard.

  • Enrollment in VGS Network Tokens.

  • Completion of Network Tokens "Token Requester IDs (TRIDs)" registration.

  • The VGS Support toggle must be enabled for your organization. VGS Support will access your organization to configure routes and access credentials for enrollment.

Enrollment Data Format

When you perform bulk enrollment of cards to VGS Network Tokens, the vital part is the format of your card data. Please see here for a sample file. The table below contains more details on the CSV file fields, which are required, and which are optional:

Column Headers/Fields
Field Type
Description

pan_alias

Required

VGS alias representing the PAN

exp_month

Required

Expiration month on the card

exp_year

Required

Expiration year on the card

name

Optional

Name of the user on the card

company

Optional

Company registered on the card

address1

Optional

Address1 of the user registered on the card

address2

Optional

Address2 of the user registered on the card

city

Optional

City of the user register on the card

region

Optional

Region of the user register on the card

country

Optional

Country of the user register on the card

postal_code

Optional

Postal Code of the user register on the card

phone

Optional

Phone Number of the user register on the card

The header row is required to for all columns/fields. The data for the optional columns/fields can be left empty

Sending VGS your Enrollment Data

You will need to submit a CSV file to VGS for us to process your backbook/bulk enrollment of your cards. VGS will create an SFTP connection specific to your organization and share the credentials with you. For this, please reach out to [email protected] and provide the following information:

  • Organization Name

  • VGS Organization ID

  • VGS PROD Vault ID

  • Contact Email

  • Contact Phone

VGS support will share the SFTP credentials in a protected link with the contact email provided, typically within 48 hrs. If you have any issues connecting to SFTP using the credentials provided or need any help troubleshooting, you can reach out to [email protected].

Once the file is processed, a response file will be generated in the same SFTP location, and VGS support will reach out to your email to notify you. You can see a sample response file here.

Next Steps

  • Submit your backbook enrollment using the CSV file format specified and inform VGS support at [email protected].

  • VGS support will notify the contact email provided once the file is processed. The file processing starts within 48 hours, and completion is based on the number of cards to be enrolled.

  • After you use bulk enrollment for your existing cards, you can continue enrolling/provisioning Network Tokens for all following cards with the Single Card enrollment/provisioning method.

Last updated