These docs are for v3.4. Click to read the latest docs for v4.0.

Documentação técnica sobre Card On File

Mudanças no request para o uso de recorrência

Transações utilizando Card on File terão o valor CDFLna tag CardDataNtryMd.

❗️

Nova tag!

A nova tag IsNewCrdOnFl será introduzida no fluxo de cartão armazenado. Ela irá sinalizar que se trata de uma transação de Card On File, estando indentada no nó Tx. Esse campo já está disponível para teste em ambiente não produtivo (Sandbox), e em breve estará em produção.

A seguir, apresentamos as tags existentes para transações de credenciais armazenadas (COF), além dos novos valores e seus respectivos casos de uso.

Primeira transação de uma série recorrente (CIT):

Cardholder Initiated Transaction (CIT) são as transações iniciadas pelo portador do cartão.
Nesse contexto, é a primeira transação de uma série recorrente como, por exemplo, uma assinatura, em que o portador cadastra as credenciais do cartão no estabelecimento comercial.

Tags necessárias:

Tags já existentes:

CardDataNtryMd = PHYS
TxEnvt = MERC
TxChanl = ECOM

Tags de Recorrência:

AddtlSvc = RECP
SvcAttr = FREC

Tag nova:

IsNewCrdOnFl = TRUE

Primeira transação de uma credencial armazenada que não pertence a uma série de recorrência (CIT):

É a primeira transação de uma credencial que está sendo armazenada pelo portador do cartão no momento da transação, mas que não está atrelada a uma recorrência.

Tags necessárias:

Tags já existentes:

CardDataNtryMd = CDFL
TxEnvt = MERC
TxChanl = ECOM

Tag nova:

IsNewCrdOnFl = TRUE

Transações subsequentes de uma série recorrente (MIT):

Merchant Initiated Transaction (MIT) são as transações iniciadas pelo estabelecimento comercial em nome do portador. Nesse contexto, são as cobranças automáticas de uma assinatura que já foi confirmada anteriormente (por transação de verificação de conta ou pela primeira transação de uma série recorrente).

Tags necessárias:

Tags já existentes:

CardDataNtryMd = CDFL
TxEnvt = MERC
TxChanl = ECOM
TxTp = SBCT

Tags de Recorrência:

AddtlSvc = RECP
SvcAttr = RREC

Tag nova:

IsNewCrdOnFl= FALSE

Transações de uma credencial armazenada para cobranças não agendadas:

São transações que indicam que a credencial está armazenada e é uma transação automática e recorrente do estabelecimento comercial, sem que o portador tenha solicitado a cobrança, porém sem estar atrelada a uma assinatura.

Exemplo: Sem Parar - Cobrança automática quando o saldo está baixo, em que o portador do cartão não interage com o estabelecimento e a não há data definida para cobrança.

Tags necessárias:

Tags já existentes:

CardDataNtryMd = CDFL
TxEnvt = MERC
TxChanl = ECOM

Tags de Recorrência

AddtlSvc = RECP
SvcAttr = RREC

Tag nova:

IsNewCrdOnFl = FALSE

Transações subsequentes de uma credencial armazenada que não pertence a uma série de recorrência (CIT):

São transações que indicam que o portador do cartão está fazendo uma compra utilizando uma credencial armazenada anteriormente no estabelecimento.

Exemplo: Uber e Ifood (uma vez que o cartão já tenha sido aprovado anteriormente).

Tags necessárias:

Tags já existentes:

CardDataNtryMd = CDFL
TxEnvt = MERC
TxChanl = ECOM

Tag nova:

IsNewCrdOnFl = FALSE

Transações subsequentes de uma credencial armazenada em cenários de No Show (MIT):

São transações que indicam que o estabelecimento comercial iniciou a cobrança de uma multa de acordo com a política de cancelamento do comerciante, de conhecimento do portador.
Exemplo: cancelamento de reserva pelo titular do cartão sem aviso prévio ao comerciante.

Tags necessárias:

Tags já existentes:

CardDataNtryMd = CDFL
TxEnvt = MERC
TxChanl = ECOM
TxTp = NOAC

Tag nova:

IsNewCrdOnFl = FALSE

Transações subsequentes de uma credencial armazenada em cenários de Cobrança Atrasada (MIT):

São transações que indicam que o estabelecimento comercial iniciou uma cobrança adicional na conta após o processamento do pagamento.
Exemplo: cobrança do frigobar do hotel após a realização do check-out.

Tags necessárias:

Tags já existentes:

CardDataNtryMd = CDFL
TxEnvt = MERC
TxChanl = ECOM
TxTp = DESL

Tag nova:

IsNewCrdOnFl = FALSE

Retentativas de transações subsequentes de uma credencial armazenada (MIT):

São transações que indicam que o estabelecimento comercial iniciou a retentativa de uma cobrança.

Tags necessárias:

Tags já existentes:

CardDataNtryMd = CDFL
TxEnvt = MERC
TxChanl = ECOM
IsRsbmsn = TRUE

Tag nova:

IsNewCrdOnFl = FALSE


📘

Regra Mastercard - Para alguns MCCs

Para transações dos seguintes MCCs: 7995 (Transações de jogos de azar); 7800 (Loteria de propriedade do governo); 7801 (Jogos de azar na Internet); 7802 (Corridas de cavalos/cães licenciadas pelo governo); 9406 (Loteria de propriedade do governo), as transações de Credential On File (sendo recorrentes ou não) sempre devem vir com CVV, exceto se forem autenticadas via 3DS com autenticação do emissor (AuthntcnRslt = CRPT) ou se forem InApp sem Wallet Identifier.