Home
Documentation
Resources
Partners
Community

Resources

Check for updates on our solutions and system performance, or request technical support.

Partners

Discover our program for agencies or developers that offer integration services and sellers who want to hire them.

Community

Get the latest news, ask others for help and share your knowledge.

Input format for vault migration - File processing - Mercado Pago Developers

Input format for migrating vaults to tokenization

The input file format must be a CSV separated by commas (","), and the file name must follow a naming convention defined by Mercado Pago, which will be communicated in due course.

Below, you can see an example:

plain

Filler,external_reference,customer_email,Filler,Filler,card_number,expiration_month,expiration_year,cardholder_name,Filler
,217307543,test1@gmail.com,,,4356141052114191,11,25,Mary Meir,
,485342254,test2@gmail.com,,,4356141052114192,02,28,Jhon Doe,

All fields are mandatory. Below are detailed descriptions of each field and their particularities:

FieldDescriptionRequired or Optional
fillerThese fields must be filled with a blank space, as they are necessary for our internal processing.Required.
external_referenceReference of the payer in the seller's system.Required.
customer_emailEmail of the paying user associated with the link.Required.
card_numberCard number (PAN).Required.
expiration_monthExpiration month of the card.Required.
expiration_yearExpiration year of the card.Required.
cardholder_nameName that appears on the card.Required.
Important
If you do not have the information for any field (for example: expiration date or cardholder name), fill in with placeholder data.

Validations for the input file

Below, we detail the validations that are performed during the processing of the input file:

  • It is important to highlight that the limit to associate cards with a single email is 20 cards. If this limit is exceeded, the corresponding line will not be processed.
  • The card expiration date must be a future date.
  • Validation will be performed on the characters of the emails and the cardholder's name.
  • The file name must conform to what was previously agreed upon.