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 presente somente quando efetuada via, Cielo eCommerce, e-Rede e e.Rede REST	= 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 &#124; 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

curl -X POST \

https://www.lojateste.com.br/status.php \

-H 'Content-Type: application/x-www-form-urlencoded' \

-H 'cache-control: no-cache' \

-d 'nsuSitef=315569&nit=9230d962f0afb40db64e082c37564f4b113c3e4fc6a5090c40813c4b0d80ca37&pedido=201808020001&status=CON'

Parâmetros enviados pelo post de aviso de status

Na 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.