Bradescard
A loja tem a possibilidade de configurar o roteamento de transações feitas no e-SiTef por vários meios de pagamento, um desses meios é o Bradescard.
Interfaces e-SiTef 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âmetro | Descrição | Formato | Obrigatório |
|---|---|---|---|
date | Data fiscal. | N | Não |
time | Hora fiscal. | N | Não |
subfunction | Subfunção da transação de consulta. Estão previstas as seguintes consultas: 01 – Consulta de saldos 02 – Consulta de extrato resumido | 2 N | Não |
card_entry_mode | Modo de entrada. Os valores possíveis para este campo são: 1 – Cartão magnético 2 – Número do cartão digitado | 1 N | Sim |
card_number | Este campo deve ser preenchido com o número do cartão. | N | CONDICIONAL Sim, se card_entry_mode for igual a "2" |
track1 | Este campo deve ser preenchido com a trilha 1 do cartão. | < 99 AN | CONDICIONAL Sim, se card_entry_mode for igual a "1" |
track2 | Este campo deve ser preenchido com a trilha 2 do cartão. | < 99 N | CONDICIONAL Sim, se card_entry_mode for igual a "1" |
card_expiry_date | Data de vencimento do cartão. | 4 N (MMAA) | CONDICIONAL Sim, se card_entry_mode for igual a "2" |
card_security_code | Código de segurança. | < 10 N | CONDICIONAL Sim, se for solicitado na consulta de cartão (Saiba mais). |
card_issue_date | Data 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âmetro | Descrição |
|---|---|
response_code | Código de resposta do e-SiTef. |
response_message | Mensagem de resposta do e-SiTef. |
authorizer_response_code | Código de resposta da autorizadora. |
authorizer_response_message | Mensagem de resposta da autorizadora. |
parameters.date | Data. |
parameters.time | Hora. |
parameters.acquirer_id | Id da rede adquirente no SiTef. |
parameters.host_usn | NSU host. |
parameters.sitef_usn | NSU SiTef. |
parameters.institution_response_code | Código de resposta da autorizadora/adquirente. |
parameters.institution_name | Nome da instituição. |
parameters.authorization_number | Número da autorização. |
parameters.affiliation_code | Código do estabelecimento na autorizadora/adquirente. |
parameters.confirmation_data | Dados da confirmação. |
parameters.customer_receipt | Comprovante do comprador. |
parameters.merchant_receipt | Comprovante da loja. |
parameters.sale_response_data | Dados de resposta da venda. |