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:
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