Consulta Status | Deeplink

Utilize o deeplink getnet://pagamento/v1/checkstatus para verificar o status de transações Pix que ficaram pendentes ou para receber as informações de transações que já foram aprovadas, sejam elas crédito, débito, voucher ou Pix.

Esta consulta só verifica o status e retorna informações de transações realizadas pelo Pagamento v3. Pois, para fazer a consulta, um callerId precisa ter sido enviado na requisição de pagamento.

Ao utilizar a Consulta Status, enviando um callerId válido, três cenários podem ocorrer:

Pix pendentes: Se o callerId, enviado na requisição, for de uma transação Pix que ficou pendente de resposta no terminal, será feito uma verificação do status desta transação Pix e uma tela de sucesso ou falha será exibida, dependendo do status. A via do estabelecimento será impressa, a via do cliente ficará disponível na tela para impressão e as informações da transação serão retornadas na resposta da requisição, do mesmo modo como ocorre ao fim de transações realizadas com o deeplink Pagamento v3. Dependendo do parâmetro allowPrintCurrentTransaction enviado na requisição, as vias podem ser impressas ou não.
Transações aprovadas: Se o callerId for de uma transação que foi aprovada, seja ela crédito, débito, voucher ou Pix, as informações da transação serão retornadas na resposta da requisição. A tela de sucesso de transação não será exibida e os comprovantes não serão impressos. Os campos da resposta são os mesmos que retornam em um deeplink Pagamento v3.
Transações que não foram aprovadas ou com callerId desconhecido: Se o callerId for de uma transação que não foi aprovada (falhou, negada, cancelada) ou com um callerId diferente do que temos armazenado no terminal, o resultado da requisição será de falha, retornando que não foram encontrados dados para o callerId informado. Isso ocorre para transações de Crédito, Débito, Voucher ou Pix.

Atenção: Esta consulta poderá ser utilizada em transação realizadas nas últimas 24 horas no terminal. Caso um callerId seja enviado de uma transação realizada a mais de 24 horas, o retorno será de falha.

Abaixo seguem as tabelas de requisição e resposta e seus respectivos parâmetros:

Request

Obrigatoriedade	Parâmetro	Formato	Descrição
OBRIGATÓRIO	callerId	String	Neste parâmetro deve-se enviar o callerId que identifica a transação a ser consultada. Este identificador é de responsabilidade da automação, e precisa ter sido utilizado em uma requisição de Pagamento v3 antes da Consulta Status.
OBRIGATÓRIO	allowPrintCurrentTransaction	String	Ao habilitar este parâmetro, o aplicativo Pagamento não vai imprimir os comprovantes do estabelecimento e do cliente. Seu aplicativo ficará responsável pela impressão dos comprovantes. Mais detalhes na seção Responsabilidade de Impressão. Para desabilitar: “false” Para habilitar: “true” Default: “false”

Response

Quando retorna?	Parâmetro	Formato	Descrição
SEMPRE	result	String	Resultado da transação, conforme a Tabela de Resultados das Funcionalidades.
OPCIONAL	resultDetails	String	Texto com detalhes do retorno, conforme a Tabela de Resultados das Funcionalidades.
OPCIONAL	amount	String	12 dígitos representando o valor, considerando os últimos 2 dígitos como casas decimais. Exemplo: 000000001234 = R$ 12,34
OPCIONAL	callerId	String	Retorna o callerId que foi enviado na requisição. Este identificador é de responsabilidade da automação.
OPCIONAL	nsu	String	Código de autorização da transação da Getnet – ele é único por terminal (CV impresso no comprovante, não pode se repetir no mesmo dia)
OPCIONAL	nsuLastSuccesfullMessage	String	Último NSU da GetNet gerado com sucesso
OPCIONAL	cvNumber	String	Número do CV – informação que deve ser enviada no estorno - ele é único por terminal
OPCIONAL	type	String	02 - Débito 11 - Crédito a vista 12 - Crédito parcelado Lojista 13 - Crédito parcelado Emissor 03 - Voucher
OPCIONAL	brand	String	Bandeira do cartão utilizado
OPCIONAL	inputType	String	021 - tarja magnética 051 - chip 071 - chip sem contato 801 - tarja magnética - fallback
OPCIONAL	installments	String	Quantidade de parcelas selecionada
OPCIONAL	gmtDateTime	String	Data e hora GMT da transação (MMDDhhmmss). Este campo representa o horário GMT
OPCIONAL	nsuLocal	String	NSU gerado no terminal( DOC impresso no comprovante, número sequencial por terminal)
OPCIONAL	authorizationCode	String	Código único de autorização (AUT impresso no comprovante, pode se repetir) * Este campo é de responsabilidade da bandeira *
OPCIONAL	cardBin	String	Os 6 primeiros dígitos do cartão
OPCIONAL	cardLastDigits	String	Os 4 últimos dígitos do cartão
OPCIONAL	extraScreensResult	String	Quando for enviada na requisição o campo extraScreens. O retorno será o mesmo só que com o campo value do field preenchido. Mais detalhes na seção Telas Adicionais.
OPCIONAL(*)	splitPayloadResponse	String	(*)Quando for enviado na requisição o Split de Pagamento. Mais detalhes na seção Payload do Split de Pagamento
OPCIONAL	cardholderName	String	Retorna o nome do portador gravado no cartão, se disponível.
OPCIONAL	automationSlip	String	Neste parâmetro enviamos as informações que devem ser incluídas nos Comprovantes Impressos do estabelecimento e do cliente para transações de Crédito, Débito ou Voucher. Seu aplicativo só é obrigado a imprimir esses campos caso você opte por usar a funcionalidade Responsabilidade de Impressão, pois nesse caso o aplicativo Pagamento não irá imprimir os comprovantes. Mais detalhes na seção Dados do Comprovante.
OPCIONAL	printMerchantPreference	boolean	Neste parâmetro retornamos se a Via do Estabelecimento deve ser impressa ou não. Ela pode variar dependendo da escolha do Estabelecimento. Esse parâmetro deve ser verificado caso você opte por usar a funcionalidade Responsabilidade de Impressão e a Via do Estabelecimento deve ser impressa conforme o retorno deste parâmetro. true – Deve ser impressa a Via do Estabelecimento nos comprovantes de venda. false – Não deve ser impressa a Via do Estabelecimento nos comprovantes de venda
OPCIONAL	orderId	String	Retorna caso um orderId tenha sido enviado na requisição. Este identificador é de responsabilidade da automação e é repassado para o Conciliador.
OPCIONAL(*)	pixPayloadResponse	String	( * ) Retorna quando a requisição de pagamentofor do tipo Pix. Mais detalhes na seção Payload do Pix.
OPCIONAL	refunded	boolean	Retorna se a transação foi estornada. true – Foi estornada. false – Não foi estornada.