Glossário

Os termos que aparecem nesta documentação, em ordem alfabética. Quando o termo é um campo da API, o nome do campo vem entre parênteses.

3-DS

A autenticação do portador na compra online, feita pelo emissor (código por SMS, aplicativo do banco, biometria). Compra autenticada pesa a favor da loja numa disputa de fraude.

Adquirente

A empresa que processa os pagamentos com cartão da loja e repassa o dinheiro a ela. É do lado da adquirente que o chargeback é cobrado da loja.

Alerta

Aviso de que um portador abriu uma disputa no banco emissor, antes de ela virar chargeback. Ver Alerta.

ARN (arn)

Acquirer Reference Number: o número que a adquirente dá à transação na compensação. Ajuda a localizar a mesma compra nos sistemas de todos os envolvidos.

Assinatura do webhook

O código HMAC-SHA256 que a Rapid envia no header X-Webhook-Signature, calculado com a sua chave de assinatura. Prova que a entrega veio da Rapid. Ver Autenticação do webhook.

Bandeira (network)

A rede do cartão, como Visa ou Mastercard. Define as regras e os prazos da disputa.

BIN (card_bin)

Os primeiros 6 a 8 dígitos do cartão. Identificam o banco emissor e o tipo de cartão.

CAID (caid)

Card Acceptor ID: o identificador da loja na adquirente. Junto com o BIN da adquirente (não o do cartão), é como os alertas de Visa são associados à sua empresa.

Captura

O registro de sinais do checkout (aparelho, aceite de termos, acesso, entrega) que viram prova na defesa. Ver Captura.

Chargeback

O estorno forçado de uma compra: o portador contesta no banco emissor e o valor volta para ele, cobrado da loja.

Chave de assinatura (secret)

A chave que a Rapid gera quando você cadastra o webhook e usa para assinar cada entrega. Aparece uma única vez no painel. Ver Autenticação do webhook.

Código de autorização (auth_code)

O código que o emissor devolve quando aprova a compra.

Credenciais (client_id, client_secret)

O par que autentica as chamadas à API por Basic Auth. Gerado no painel. Ver Autenticação.

Descriptor (descriptor)

O nome da loja que aparece na fatura do cartão. É como os alertas de Mastercard são associados à sua empresa, e o motivo de muita disputa: quem não reconhece o nome, contesta.

Disputa

A contestação de uma compra pelo portador. Também o nome do produto da Rapid que defende o chargeback já aberto. Ver Disputa.

ECI (eci)

Electronic Commerce Indicator: o indicador que diz se e como a compra online foi autenticada (por exemplo, com 3-DS).

Emissor

O banco que emitiu o cartão do portador. É onde a disputa começa.

Evidência

Uma prova registrada sobre uma transação (aceite de termos, acesso, entrega, comunicação) para sustentar a defesa. Ver Evidência.

Idempotência

Processar o mesmo evento duas vezes sem efeito duplicado. Necessária porque o webhook pode chegar mais de uma vez. Ver Idempotência.

MCC (mcc)

Merchant Category Code: o código de quatro dígitos que classifica o ramo da loja.

Merchant

A loja, marca ou vendedor de uma empresa cliente. Uma empresa pode ter vários. Ver Listar merchants.

Portador

A pessoa dona do cartão usado na compra.

Prevenção

O produto da Rapid que responde ao banco emissor com os dados do pedido para a disputa não nascer. Ver Prevenção.

Status do alerta (status)

A situação do alerta: pending, notfound, account_suspended, other ou expired. Ver Regras e prazos.

Token publicável

O token do snippet de captura, que fica no HTML da loja. Só permite enviar eventos, nunca ler dados. Ver Instalar o snippet.

Transação

Uma venda enviada à Rapid pela API de Transações. É o material da Prevenção e da Disputa.

Webhook

O POST que a Rapid faz na URL que você cadastrou, a cada evento (alerta novo, corte de acesso). Ver Webhook.