Serviço de Aviso de status
No cadastro da loja deve ser informada uma URL de Status, onde o Carat irá enviar um POST contendo o status da transação com os seguintes parâmetros:
Parâmetro | Descrição | Formato |
---|---|---|
nit | NIT da transação | = 64 A |
pedido | Código do Pedido (na loja) | < 20 A |
nsu | Número sequencial enviado pela loja | < 12 N |
nsuSitef | Número sequencial único do SiTef | < 10 A |
nsuHost | Número sequencial único da Autorizadora | < 20 A |
nsuesitef | NSU do Carat | = 15 A |
status | Status do pedido. Saiba mais. | = 3 A |
cupom | Cupom do pagamento (via do cliente) em caso de pagamento efetuado. Não contém quebras de linha, cada linha é separada por @ ao invés de quebra de linha. | < 4000 A |
cupomEstabelecimento | Cupom do estabelecimento em caso de pagamento efetuado. Não contém quebras de linha, cada linha é separada por um @ . | < 4000 A |
autorizadora | Código da Autorizadora (no Carat). Saiba mais. | < 10 A |
tipoPagamento | Tipo do pagamento: C =Crédito, D =Débito, B =Boleto | = 1 A |
dataSitef | Data do pagamento no formato DD/MM/AAAA hh:mm:SS .Atenção: este parâmetro só é enviado para transações confirmadas que foram roteadas pelo SiTef. | = 19 A |
dataEfetivacao | Data do pagamento no formato DD/MM/AAAA hh:mm:SS no caso de pagamentos que não forem via SiTef.Atenção: este parâmetro só é enviado para transações confirmadas que não foram roteadas pelo SiTef. | = 19 A |
parcelas | Número de parcelas | < 2 N |
tipoFinanciamento | Tipo do financiamento escolhido pelo cliente. 3 = parcelado administradora (com juros), 4 = parcelado loja (sem juros). | = 1 N |
mensagem | Mensagem da autorizadora | < 1024 A |
codigoRespostaAutorizadora | Código de Resposta da autorizadora | < 1024 A |
rede | Nome da rede pela qual o pagamento está sendo efetuado | < 500 A |
numeroAutorizacao | Número da autorização (gerado pela autorizadora) | = 6 A |
tid | TID da transação | = 40 A |
eci | Eletronic Comerce Indicator (ECI) | = 3 A |
bandeira | Código da bandeira utilizada na transação. OBS.: Este campo normalmente é enviado em transações via SiTef | < 5 N |
analise.status | Status da transação de análise de risco. (NOV = nova, EXP = expirada, ACC = aceita, REJ = negada, REV = em análise) | =3 A |
analise.codigo | Código numérico de retorno. | < 3N |
analise.mensagem | Mensagem de retorno da instituição de análise | <30 A |
NITTransacaoSecundaria | NIT’s das transações secundárias (separadas por | pipe), para transações split. | < 1040 A |
binCartao | BIN (6 primeiros dígitos) do cartão usado para pagamento. | = 6 N |
finalCartao | Últimos 4 dígitos do cartão usado para pagamento. | = 4 N |
Em adição aos campos descritos acima, caso uma transação de recarga for vinculada os seguintes campos serão retornados:
Parâmetro | Descrição | Formato |
---|---|---|
recarga.nit | Identificador NIT da transação. | = 64 A |
recarga.nsusitef | Número sequencial único do SiTef. | < 10 A |
recarga.nsuhost | Número sequencial único da Autorizadora. | < 20 A |
recarga.nsuesitef | NSU do Carat. | = 15 A |
recarga.status | Status do pedido | = 3 A |
recarga.cupom | Cupom de recarga (via do cliente) em caso de recarga efetuada. Não contém quebras de linha, cada linha é separada por “@” ao invés de quebra de linha. | < 4000 A |
recarga.cupomestabelecimento | Cupom do estabelecimento em caso de recarga efetuada. Não contém quebras de linha, cada linha é separada por um “@”. | < 4000 A |
recarga.codigoconcessionaria | Código da Concessionária (no GwCel). | < 10 A |
recarga.rede | Código da Adquirente. | < 4 N |
recarga.dataefetivacao | Data do pagamento no formato DD/MM/AAAA hh:mm:SS no caso de pagamentos que não forem via SiTef. ATENÇÃO: este parâmetro só é enviado para transações confirmadas que não foram roteadas pelo SiTef. | = 19 A |
recarga.dataefetivacaositef | Data do pagamento no formato DD/MM/AAAA hh:mm:SS. ATENÇÃO: este parâmetro só é enviado para transações confirmadas que foram roteadas pelo SiTef. | = 19 A |
recarga.dadosconfirmacao | Dados de confirmaçãoda recarga (sequência alfanumérica). | = 12 A |
recarga.telefone | Número de telefone da recarga. | < 20 N |
recarga.ddd | Código de área do telefone descrito na recarga. | < 4 N |
recarga.valor | Valor da recarga. | < 12 N |
recarga.codigorespostahost | Código de resposta enviado pela concessionária. | < 4 N |
recarga.codigorespostasitef | Código de resposta enviado pelo SiTef. | < 4 N |
recarga.mensagemrespostahost | Mensagem de resposta enviada pela concessionária. | < 64 A |
recarga.mensagemrespostasitef | Mensagem de resposta enviada pelo SiTef. | < 64 A |
Importante:
Além dos parâmetros acima o Carat pode devolver outros sem aviso prévio. Por favor, esteja preparado para receber parâmetros extras além dos da tabela acima, que podem ser ignorados. Porém, em alguns casos parâmetros adicionais retornados por determinadas autorizadoras serão enviados juntamente.
Não é necessário devolver nada no POST, porém se o POST não for bem-sucedido (HTTP Status-Code 200: OK), o Carat tentará de novo até o número de vezes configurado no sistema, antes de desistir e deixar a transação como pendente de aviso, conforme as figuras abaixo.
O POST/HTTPS do Carat pode não ser imediato, mas sim, será assíncrono, com o tempo podendo variar conforme carga do servidor e da Internet. Caso haja algum problema no envio, o Carat tentará reenviar a mensagem após um determinado período de tempo, sendo 3 (três) tentativas.
Nem todos os parâmetros podem estar presentes em todas as transações, alguns parâmetros podem não ser enviados dependendo da forma de pagamento ou se a transação não for concluída, por exemplo.
Tentativas de aviso de mudança de status:
Tentativas sem sucesso de aviso de mudança de status:
POST de aviso de status:
Segue um exemplo de um post de aviso de status
#
Parâmetros enviados pelo post de aviso de statusNa tabela abaixo está a descrição dos parâmetros enviados pelo Carat no POST de de aviso de status:
Parâmetro | Descrição | Formato |
---|---|---|
nsuSitef | Número da Transação | = 6 AN |
nit | Identificador da transação de pagamento no Carat. | = 64 AN |
pedido | Código de identificação do pedido gerado pela loja | < 20 AN |
status | Indica o Status de uma transacao no e-SiTef. | = 3 N |
O Carat também pode enviar novos parâmetros sem aviso prévio, o que significa que a aplicação do lojista deve estar preparada para receber campos extras e simplesmente ignorá-los.