Token Import

In order to successfully migrate existing tokens, Preczn includes a Token Import utility for your convenience. This functionality offers you the ability to safely and securely migrate tokens into Preczn.

Preczn recommends working with us directly in order to ensure this process proceeds smoothly, as documentation will likely need to be provided to the current token owner.
In order to initiate the process of receiving an export of your tokens, you will need to be in contact with the party who currently owns your tokens.

This document outlines any additional information you might need from Preczn in order to assist with this process.

 

Supported Token Import Formats

Currently Preczn Token Import supports two file formats for importing tokens from other payment processors:

• Preczn CSV format
• Stripe's JSON file spec

An example of the Preczn CSV format is provided below:

In the event you need to import tokens from another processor, please reach out to your Preczn support team.

 

Encryption and Armoring

Preczn utilizes Pretty Good Privacy (PGP) to encrypt and decrypt token import files. This enables Preczn to securely handle and manage files which contain sensitive data.

In order to upload a token import file to Preczn, the file must be encrypted with Preczn's current public PGP key and be armored. Please encrypt using the the following PGP Public key:

 

 

Uploading

Once you have a properly encrypted token import file, you can upload to Preczn via the Token Import page! Access Preczn Token Import under the Settings dropdown within the lefthand navigation pane:

 

 

 

On this page you will also find links for Preczn's public PGP key, as well as this tutorial, should you need them.

 

 

 

Once you've selected the appropriate ownership and format of the token, you can upload the file.

On upload, Preczn validates that each file is encrypted with our current PGP Public Key.

Next, you will see the status of each token file in the list of imports.

 

Response

Once your Token Import has been completed, the user who initiated the import will be notified of completion via email.

You will then have the ability to download a response file via the Preczn UI as seen below:

 

 

Within the response file you will receive a mapping of the original owner's token ID (if applicable), the new Preczn token ID, the last 4 digits of the card number, and status indicating whether each card was imported correctly.

A sample of this can be seen below: