Card On File

ℹ️

Vá para a Referência da API para acessar os exemplos completos de requisição e resposta.

O que é o Card On File?

As transações de Card on File (COF) são utilizadas por estabelecimentos comerciais para enviar transações financeiras e não financeiras (validação de cartão) com credenciais armazenadas.

ℹ️

Essa funcionalidade é válida para cartão de crédito e débito.

A maioria dessas transações não contém um CVV pois as regras PCI impedem o estabelecimento de armazenar esse valor. Porém é importante considerar que um estabelecimento comercial pode ter validado o CVV em uma transação anterior, como no momento da primeira transação Card On File.

São exemplos de segmentos que usam esse tipo de modalidade os serviços de streaming, serviços de educação, academias e assinaturas, entre outros.

⚠️

Atenção

A transação com Card On File pode ser recorrente ou não.

Qual é o impacto do uso no meu negócio?

O Card On File permite maior agilidade na compra online, uma vez que não solicita que o portador do cartão envie novamente todos os dados (inclusive o CVV); também é possível notar uma melhor taxa de conversão de vendas uma vez que no processo para utilização do COF iniciada pelo estabelecimento comercial, obrigatoriamente, já existe uma transação anterior iniciada pelo portador de cartão que já auxilia na autorização da transação pelo emissor.

O uso do Card On File pode melhorar a conversão de transações recorrentes e de retentativas de cartão não presente.

Como usar o Card On File?

Primeiro é necessário armazenar o cartão, e então já é possível utilizar a marcação de Card On File.

• Caso seja a primeira transação (com ou sem valor financeiro) de um cartão armazenado, envie o campo CardOnFile.Usage com o valor "First";
• A partir da segunda transação, envie o campo CardOnFile.Usage com o valor "Used";

Exemplo do nó CardOnFile:

	"CardOnFile":{
            "Usage": "Used",
            "Reason":"Recurring"

O que não fazer?

Não envie a marcação de Card On File para transações sem o cartão armazenado.

ℹ️

Importante

Antes de armazenar o cartão, é muito importante utilizar o Zero Auth com CVV, para validar os dados do cartão.

Bandeiras Suportadas

O Card On File suporta as seguintes bandeiras:

• Mastercard
• Visa
• Elo

Para transações Card On File com a bandeira Mastercard é necessário enviar o nó de indicador do início da transação (Payment.InitiatedTransactionIndicator), para informar se a transação foi iniciada pelo comprador ou pela loja. Saiba mais em Indicador de Início da Transação Mastercard.