Token Migration

If you are moving to a different payment processor or gateway, TranSafe can assist with migrating your tokenized credit card data to your new platform.

Credit card data can only be released to PCI-validated entities that will process transactions. A current PCI Attestation of Compliance (AOC) must be obtained by TranSafe from your new processor before a card data migration can be authorized. We will also need the processor's PGP public encryption key (4096 bits or greater), which will allow us to securely transmit your credit card data. The key must be publicly available from an HTTPS-hosted website associated with the processor. We cannot accept a PGP key emailed to us or from a file sharing service.

Once we have received this information from your new processor, we will generate an encrypted file containing your customers' stored credit card data and deliver it directly to your new processor. They will be able to decrypt this file and use it to import the data into their system.

Token migration data only includes payment account details. Customer information and recurring payment schedules can be retrieved directly from the TranSafe Portal or API. Token export does not affect our standard customer data retention policy.

The encrypted token export file will contain CSV data with the following headers:

token, create_ts, update_ts, flags, status, cardtype, abaroute, account, expdate, cardholdername, descr, clientref, customer_id, street, zip, descmerch, descloc

The definitions of those fields are as follows:

Field Name Field Description
token TranSafe token ID
created_tsUnix timestamp the token was created
update_tsUnix timestamp the token was last updated
flagsPROC_TOKEN, ACCT_BUSINESS, ACCT_SAVINGS
statusENABLED, DISABLED, AU_DISABLED
cardtypeCard type
abarouterouting number for ACH
accountAccount number
expdateExpiration date
cardholdernameCard holder or bank account holder name
descrDescription
clientrefClient reference number
customer_idTranSafe ID of a linked customer
streetStreet address
zipZip code
descmerchSoft descriptor of merchant name
desclocSoft descriptor of merchant location

Our own public key (for migrating to TranSafe from another processor) is available here.


PGP Public Key Download
-----BEGIN PGP PUBLIC KEY BLOCK-----

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
Ypbz7bC7CSXKyK/AsJAmJCmJ
=DC0t
-----END PGP PUBLIC KEY BLOCK-----