Bradescard

A loja tem a possibilidade de configurar o roteamento de transações feitas no Carat por vários meios de pagamento, um desses meios é o Bradescard.

Interfaces Carat suportadas para integração#

Utilizaremos as seguintes interfaces para a integração com o roteamento Bradescard:

  • Pagamento REST
  • Pagamento HTML
  • Cancelamento REST
  • Cancelamento via Portal do Lojista
  • Operação genérica para realizar consultas Bradescard

Serviço de Consultas Bradescard#

Nas consultas Bradescard é possível realizar a consulta de extrato resumido e a consulta de saldos de um determinado cartão.

Detalhes da chamada#

O serviço de consulta Bradescard é um serviço disponibilizado pela interface de operação genérica (Saiba mais). No caso da operação de consulta Bradescard, é obrigatório o token de autenticidade para cada consulta realizada, logo é necessário obter o token (Saiba mais) e depois realizar a chamada de operação genérica (Saiba mais).

A consulta Bradescard é identificada com o código de operação 172 (utilize este valor no campo operation na requisição).

Parâmetros das consultas Bradescard#

Abaixo, seguem os parâmetros que são utilizados pela operação de consultas Bradescard.

ParâmetroDescriçãoFormatoObrigatório
dateData fiscal.NNão
timeHora fiscal.NNão
subfunctionSubfunção da transação de consulta. Estão previstas as seguintes consultas:
01 – Consulta de saldos
02 – Consulta de extrato resumido
2 NNão
card_entry_modeModo de entrada. Os valores possíveis para este campo são:
1 – Cartão magnético
2 – Número do cartão digitado
1 NSim
card_numberEste campo deve ser preenchido com o número do cartão.NCONDICIONAL
Sim, se card_entry_mode for igual a "2"
track1Este campo deve ser preenchido com a trilha 1 do cartão.< 99 ANCONDICIONAL
Sim, se card_entry_mode for igual a "1"
track2Este campo deve ser preenchido com a trilha 2 do cartão.< 99 NCONDICIONAL
Sim, se card_entry_mode for igual a "1"
card_expiry_dateData de vencimento do cartão.4 N (MMAA)CONDICIONAL
Sim, se card_entry_mode for igual a "2"
card_security_codeCódigo de segurança.< 10 NCONDICIONAL
Sim, se for solicitado na consulta de cartão (Saiba mais).
card_issue_dateData da emissão do cartão.6 N (MMAAAA)CONDICIONAL
Sim, se for solicitado na consulta de cartão (Saiba mais).

Parâmetros de resposta#

Em caso de sucesso, o código de resposta HTTP será 200. Qualquer outro código deve ser interpretado como erro. Na tabela abaixo está a descrição dos parâmetros de resposta do serviço de consultas Bradescard:

ParâmetroDescrição
response_codeCódigo de resposta do Carat.
response_messageMensagem de resposta do Carat.
authorizer_response_codeCódigo de resposta da autorizadora.
authorizer_response_messageMensagem de resposta da autorizadora.
parameters.dateData.
parameters.timeHora.
parameters.acquirer_idId da rede adquirente no SiTef.
parameters.host_usnNSU host.
parameters.sitef_usnNSU SiTef.
parameters.institution_response_codeCódigo de resposta da autorizadora/adquirente.
parameters.institution_nameNome da instituição.
parameters.authorization_numberNúmero da autorização.
parameters.affiliation_codeCódigo do estabelecimento na autorizadora/adquirente.
parameters.confirmation_dataDados da confirmação.
parameters.customer_receiptComprovante do comprador.
parameters.merchant_receiptComprovante da loja.
parameters.sale_response_dataDados de resposta da venda.

Códigos de resposta

Veja a referencia no Códigos da API - códigos de resposta

Bradescard Voucher#

O Bradescard Voucher permite à um cliente que ainda não tem um cartão Bradescard realizar uma compra com este cartão numa loja física parceira do Bradescard. Este cenário é exclusivo para o roteamento da Bradescard.

Neste caso, existem dois cenários:

  • A loja possui uma impressora de cartões Bradescard e gera um cartão na hora.
  • A loja não possui uma impressora de cartões Bradescard, então gera uma solicitação e recebe um PDF contendo as informações necessárias para efetuar a transação.

Interfaces Carat suportadas para integração#

Utilizaremos as seguintes interfaces para a integração com o roteamento Bradescard Voucher:

  • Pagamento REST
  • Cancelamento REST
  • Cancelamento via Portal do Lojista

Pagamento REST#

O pagamento via Bradescard Voucher segue o fluxo transacional de pagamentos REST, sendo diferenciado pelo envio obrigatório dos campos abaixo durante a operação de pagamento:

  • card.number - número do cartão fictício;
  • acquirer.authorization_number - código de autorização do voucher.

Demais campos relacionados aos dados do cartões (cvv, data de expiração etc.) não são utilizados.

Cancelamento#

O cancelamento de transações via Bradescard Voucher segue o fluxo já existente, sem necessidade de envio de campos novos.

Para cancelamento via Portal do Lojista, é necessário preencher o número de cartão utilizado na transação.

Para mais detalhes, consulte as documentações abaixo:

Consultas de Saldo e Extrato#

O Bradescard Voucher não permite consultas de saldo e de extrato.