Recursos para IA

Formato de entrada para migração de cofres

O formato do arquivo de entrada deve ser CSV separado por vírgulas (,), com codificação UTF-8 sem BOM, e o nome do arquivo deve seguir a convenção definida na seção Nomenclatura do arquivo.

A seguir, mostramos um exemplo:

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

Todos os campos são obrigatórios. A seguir, estão as descrições detalhadas de cada campo, sua posição no CSV e suas particularidades:

Posição	Campo	Descrição	Formato	Exemplo	Tipo
1	`filler`	Deve ser preenchido como uma cadeia vazia (`""`) e não como `null` ou `nil`. É necessário para nosso processamento interno.	—	`""`	Obrigatório
2	`external_reference`	Referência do pagador no sistema do vendedor.	Caracteres alfanuméricos	`ORD-123456`	Obrigatório
3	`customer_email`	E-mail do usuário pagador associado à vinculação.	Caracteres alfanuméricos	`cliente@email.com`	Obrigatório
4	`filler`	Deve ser preenchido como uma cadeia vazia (`""`). É necessário para nosso processamento interno.	—	`""`	Obrigatório
5	`filler`	Deve ser preenchido como uma cadeia vazia (`""`). É necessário para nosso processamento interno.	—	`""`	Obrigatório
6	`card_number`	Número do cartão (PAN).	Caracteres numéricos (entre 13 e 19)	`1234567812345678`	Obrigatório
7	`expiration_month`	Mês de vencimento do cartão.	Caracteres numéricos (2)	`01`	Obrigatório
8	`expiration_year`	Ano de vencimento do cartão, no formato de 2 dígitos (`YY`) correspondente ao século XXI (ex: `27` = 2027).	Caracteres numéricos (2)	`27`	Obrigatório
9	`cardholder_name`	Nome que aparece no cartão.	Utilize somente letras sem acentos e espaços, evitando números e caracteres especiais, como `.` `,` `;` `:` `-` `_` `/` `\` `'` `"` `&` `@` `+` `(` `)` `ñ` e `ç`.	`ATILIO GARCIA`	Obrigatório
10	`filler`	Deve ser preenchido como uma cadeia vazia (`""`). É necessário para nosso processamento interno.	—	`""`	Obrigatório

Nomenclatura do arquivo

O nome do arquivo .csv deve conter apenas letras, números, hifens (-), sublinhados (_) e pontos (.).

Exemplos válidos:

migracao_cofre_2027.csv
seller-123_customers.csv

Exemplos inválidos:

migração cofre.csv (espaços e caracteres especiais não são permitidos)
arquivo@clientes.csv (o caractere @ não é permitido)

Validações do arquivo de entrada

A seguir, detalharemos as validações que são realizadas durante o processamento do arquivo de entrada:

O arquivo deve estar codificado em UTF-8 sem BOM.
O limite de conteúdo é de 400.000 linhas por arquivo. Se o volume ultrapassar esse limite, recomenda-se dividi-lo em múltiplos arquivos.
O limite do arquivo é de 100 MB.
É importante ressaltar que o limite para associar cartões a um único e-mail é de 20 cartões. Se esse limite for ultrapassado, a linha correspondente não poderá ser processada.
A data de vencimento do cartão deve ser uma data futura.
O campo cardholder_name deve conter somente letras sem acentos e espaços, evitando números e caracteres especiais, como . , ; : - _ / \ ' " & @ + ( ) ñ e ç.
O campo customer_email deve ter formato de e-mail válido.
Os campos filler devem ser preenchidos como uma cadeia vazia (""), nunca como null ou nil.

Erros frequentes no arquivo

Consulte os problemas mais comuns ao preparar o arquivo e como resolvê-los.

Problema	Exemplo inválido	Como corrigir
`cardholder_name` com caracteres não permitidos	`JOSE PEREZ S.A.`, `MARÍA GÓMEZ`, `JOÃO SILVA`, `ANA-MARIA`, `CLIENTE & CIA`	Use somente letras sem acentos e espaços como, por exemplo, `JOSE PEREZ`, `MARIA GOMEZ`, `JOAO SILVA`.
Arquivo CSV mal exportado	Toda a linha fica entre aspas ou é usado outro separador	Exporte o arquivo como CSV separado por vírgulas e mantenha o header exato do template.
Linhas vazias	Uma linha sem dados entre registros	Remova as linhas vazias antes de enviar o arquivo.
Cartão vencido	`expiration_month=01`, `expiration_year=24`	Envie somente cartões com data de vencimento futura.
`card_number` incorreto	Token, `card_id` ou identificador interno em vez do PAN	Envie o PAN plano do cartão, com 13 a 19 dígitos.
`customer_email` com formato inválido	`cliente@`, `cliente.com`, `cliente@@email.com`	Use um e-mail com formato padrão como, por exemplo, `cliente@email.com`.

Anterior Links de vinculaçãoGere um link seguro para o comprador vincular o cartão a um perfil de pagamentos automáticos.

PróximoFormato de saída para migração de cofresSaiba como gerar uma saída para migrações de cofres.