Aviso de Status
A cada mudança de status da transação, o e-SiTef avisará à loja sobre tais mudanças conforme a figura abaixo:
No cadastro da loja deve ser informada uma URL de Status, onde o e-SiTef 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 e-SiTef | = 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 e-SiTef). 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, presente somente quando efetuada via, Cielo eCommerce, e-Rede e e.Rede REST | = 40 A |
eci | Eletronic Comerce Indicator (ECI) da transação presente somente quando efetuada via Verified By Visa ou Secure Code Mastercard. | = 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 e-SiTef. | = 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 e-SiTef 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 e-SiTef 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 e-SiTef 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 e-SiTef 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 sem sucesso de aviso de mudança de status: