Pesquisar

Are you looking for test card numbers?

Would you like to contact support?

Atenção, esta página não se encontra disponível em Português
Point-of-sale icon

Determine the current and final tender state

Use the following methods to retrieve the current or final state of a tender.

The pos_result_code visible in your logs refers to the result of communication between the library and the PED and does not represent the final state of a transaction.

Method

Name

Description

GetTenderState

Returns the current state result code. The first status to be checked during the transaction. If the tender state is not OK, something went wrong.

Object

Name Description
finalObj Run GetFinalStateCode against this object to get the final state of the transaction. Do this after the final transaction callback.

Method

Name Description
GetResponseHeader Return the response header of the final object.

GetResponseHeader returns:

Object

Name Description
ResponseHdr Run GetFinalStateCode against this object to get the final state of the transaction. Do this after the final transaction callback

Method

Name Description
GetTenderState Apply this to the response header of the final callback to return the final state of the transaction.

O campo TenderState retorna o estado atual de uma transação. O estado final é o estado final de uma transação concluída. Os valores desses campos explicam o que está acontecendo com o pagamento:

Estados TenderState

Estado Descrição
ACKNOWLEDGED A transação foi confirmada, mas não foi aprovada, recusada, cancelada ou falhou por engano.
ADDITIONAL_DATA_AVAILABLE Dados adicionais (como alias do cartão (token), tipo de cartão e código do país do emissor) estão disponíveis.
APPLICATION_SELECTED O cliente selecionou sua aplicação de pagamento preferida.
APPROVED A transação foi aprovada.
ASK_DCC O terminal está verificando se o cliente requer conversão dinâmica de moeda.
ASK_GRATUITY O terminal está aguardando uma possível gratuidade.
ASK_SIGNATURE O PED solicitou a assinatura do cliente.
BALANCE_QUERY_ACQUIRED Confirma o saldo adquirido e permite que o usuário execute as próximas etapas.
BALANCE_QUERY_COMPLETED A solicitação de saldo do cartão foi concluída.
BALANCE_QUERY_STARTED O terminal está solicitando o saldo em um cartão.
CANCELLED A transação foi cancelada.
CARD_DETAILS_PROVIDED Os detalhes do cartão foram inseridos.
CARD_INSERTED Um cartão foi inserido.
CARD_METHOD_SELECTED Um cartão é apresentado ao terminal para uma transação por aproximação (NFC).
CARD_MKE O PED está aguardando a inserção dos detalhes do cartão usando a Venda digitada (MKE). Este é usado como recurso se o chip e a tarja magnética não estiverem funcionando.
CARD_SWIPED Um cartão foi passado..
CHECK_SIGNATURE O terminal está aguardando o caixa verificar a assinatura.
DCC_ACCEPTED O cliente solicitou a conversão dinâmica de moeda.
DCC_REJECTED O cliente rejeitou a conversão dinâmica da moeda.
DECLINED Essa resposta mapeia todos os códigos de resposta que não podem ser mapeados de maneira confiável.
Isso facilita a identificação de recusas genéricas (por exemplo, Mastercard "05: Não realizada") das mais específicas.
ERROR A transação não foi concluída porque ocorreu um erro.
GRATUITY_ENTERED O valor da gratuidade foi inserido.
INITIAL Uma transação foi iniciada.
LOAD_COMPLETED Uma carga de um valor no cartão foi concluída.
LOAD_STARTED Uma carga de um valor no cartão foi iniciada.
PIN_DIGIT_ENTERED Um dígito do PIN foi inserido.
PIN_ENTERED O PIN inteiro foi inserido.
PRINT_RECEIPT O terminal está imprimindo o recibo.
PROCESSING_TENDER O pagamento está sendo processado. O terminal exibe uma barra de progresso.
PROVIDE_CARD_DETAILS O terminal está aguardando detalhes do cartão.
RECEIPT_PRINTED Um recibo foi impresso.
REFERRAL O adquirente envia um status de referência.
REFERRAL_CHECKED O código de referência foi verificado.
SIGNATURE_CHECKED O caixa verificou e confirmou a assinatura.
TENDER_CREATED O tender foi criado com sucesso.
UNKNOWN O estado do tender é desconhecido e não é possível determiná-lo. 
Se você estiver usando o recurso TxStore, poderá verificar o resultado da transação lá. Caso contrário, você pode verificar o menu de transações no PED.
WAIT_FOR_AMOUNT_ADJUSTMENT Aguardando que um valor seja ajustado com base na gratuidade.
WAIT_FOR_APP_SELECTION O terminal está aguardando o cliente selecionar uma aplicação de pagamento.
WAIT_FOR_PIN Um PIN é solicitado no terminal.

Estados finais

Estado Descrição
APPROVED A transação foi aprovada.
CANCELLED A transação foi cancelada.
DECLINED A transação foi recusada.
ERROR A transação não foi concluída porque ocorreu um erro.
UNKNOWN O estado do tender é desconhecido e não é possível determiná-lo. Se você estiver usando o recurso TxStore, poderá verificar o resultado da transação lá. Caso contrário, você pode verificar o menu de transações no PED.