Token Import

In order to successfully migrate existing tokens, Preczn provides the ability to import existing tokens for your convenience. This functionality offers you the ability to safely and securely migrate tokens into Preczn.

We advise you work with us directly in order to ensure this process proceeds smoothly, as documentation will likely need to be provided to the current token service provider.

In order to initiate the process of receiving an export of your tokens, you will need to contact your current token or payment service provider.

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

Preczn CSV Token Import Format

The standard Preczn CSV format for accepting token import files consists of the following fields (columns in CSV):

Field NameDescription
number *The primary account number (PAN) of the credit card (typically masked or tokenized).
expiration *The expiration date of the credit card (MMYY format).
token *The token used to represent the account.
firstNameThe cardholder's first name, if provided.
lastNameThe cardholder's last name, if provided.
emailThe cardholder's email address, if provided.
addressThe primary street address for the cardholder's billing address.
address2Additional address information (e.g., apartment or suite number), if provided.
cityThe city of the cardholder's billing address.
regionThe state, province, or region of the billing address.
postalThe postal or ZIP code of the billing address.
countryThe country of the billing address.

ℹ️ Required fields for each token are defined in bold and denoted by an asterisk (*)

Example CSV Data

number,expiration,token,firstName,lastName,email,address1,address2,city,region,postal,country
4111111111111111,0430,card_f630eq9arrdg,Geoffrey,Leora,[email protected],495 Tomas Extensions,,Minot,Georgia,99406,USA
4242424242424242,0741,card_01i0t58immdx,Doyle,Mallory,[email protected],4107 Ethyl Lakes,,Lake Herta,Kansas,55380,USA

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 have your provider encrypt using the the following PGP Public key:


Receiving

Please reach out to your Preczn account manager or Preczn support and we will coordinate with your PSP to furnish our AoC and securely receive any token export data.