Network Tokens Bulk Enrollment - V1

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: https://www.verygoodsecurity.com/docs/vgs_theme/static/vgs-nt-sample-file.csv

The table below contains the CSV file fields, which are required or 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 registered on the card
region	Optional	Region of the user registered on the card
country	Optional	Country of the user registered on the card
postal_code	Optional	Postal Code of the user registered on the card
phone	Optional	Phone Number of the user registered on the card

The header row is required for all columns/fields. Data for 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. To get started, contact [email protected] and provide the information below.

1

Provide organization details to [email protected]

Include the following in your message:

• Organization Name

• VGS Organization ID

• VGS PROD Vault ID

• Contact Email

• Contact Phone

2

Receive SFTP credentials

VGS Support will share the SFTP credentials in a protected link with the contact email provided, typically within 48 hours.

3

Upload your CSV

Use the provided SFTP credentials to upload your CSV file to the designated location.

4

File processing and response

Once the file is processed, a response file will be generated in the same SFTP location. VGS Support will notify the contact email when processing starts/completes.

You can see a sample response file here: https://www.verygoodsecurity.com/docs/vgs_theme/static/vgs-nt-processed-sample.csv

If you have issues connecting to SFTP or need troubleshooting, reach out to [email protected].

Next Steps

1

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

2

VGS Support will notify the contact email provided once the file is processed. Processing starts within 48 hours; completion time depends on the number of cards to be enrolled.

3

After bulk enrollment of your existing cards, continue enrolling/provisioning Network Tokens for new cards using the Single Card enrollment/provisioning method: enroll-network-token.md