Tender state reference sheet

Outlines what tender states mean, and recommended actions for specific states.


The TenderState field returns the current state of a transaction. The final state is the final state of a completed transaction. The values of these fields explain what's happening with the payment: 

TenderState states

State

Description

ACKNOWLEDGED
The transaction is acknowledged, but not approved, declined, cancelled or failed in error.

ADDITIONAL_DATA_AVAILABLE

Additional data (like card alias (token), card type and issuer country code) are available.

APPLICATION_SELECTED

The customer has selected their preferred payment application.

APPROVED The transaction has been approved.

ASK_DCC

The terminal is checking if the customer requires dynamic currency conversion.

ASK_GRATUITY

The terminal is waiting for a possible gratuity.

ASK_SIGNATURE The PED has requested a signature from the shopper.
BALANCE_QUERY_ACQUIRED Confirms the acquired balance and allows the user to take next steps,
BALANCE_QUERY_COMPLETED The request for card balance has completed.
BALANCE_QUERY_STARTED The terminal is requesting the balance on a card.
CANCELLED The transaction was cancelled.
CARD_DETAILS_PROVIDED The card details have been entered.

CARD_INSERTED

A card was inserted.

CARD_METHOD_SELECTED
A card is presented to the terminal for a contactless/NFC transaction
CARD_MKE

The PED is waiting for card details to be entered using Manual Keyed Entry (MKE). This is used as a fall back if chip and magnetic stripe are not working.

CARD_SWIPED

A card was swiped.

CHECK_SIGNATURE

The terminal is waiting for the cashier to check the signature.

DCC_ACCEPTED

The customer requested Dynamic Currency Conversion.

DCC_REJECTED

The customer rejected Dynamic Currency Conversion.

DECLINED This response maps all those response codes that cannot be reliably mapped.
This makes it easier to tell generic declines (for example, Mastercard "05: Do not honor" response) from more specific ones.
ERROR The transaction did not go through as an error occurred.

GRATUITY_ENTERED

The gratuity amount was entered.

INITIAL

A transaction was initiated.

LOAD_COMPLETED A load of a value on the card has completed.
LOAD_STARTED A load of a value on the card has started.
PIN_DIGIT_ENTERED A digit of the PIN was entered.
PIN_ENTERED The whole PIN was entered.

PRINT_RECEIPT

The terminal is printing the receipt.

PROCESSING_TENDER

The payment is being processed. The terminal displays a progress bar.

PROVIDE_CARD_DETAILS The terminal is waiting for card details.
RECEIPT_PRINTED A receipt was printed.
REFERRAL The acquirer sends a referral status.
REFERRAL_CHECKED The referral code was checked.
SIGNATURE_CHECKED The cashier has checked and confirmed the signature.

TENDER_CREATED

The tender was created successfully.

UNKNOWN The tender state is unknown, and it is not possible to determine it.  
If you are using the TxStore feature, you can check the transaction result there. If not, you can check the transactions menu on the PED.

WAIT_FOR_AMOUNT_ADJUSTMENT

Waiting for an amount to be adjusted based on the gratuity.

WAIT_FOR_APP_SELECTION

The terminal is waiting for the shopper to select a payment application.

WAIT_FOR_PIN

A PIN is requested at the terminal.

Final States

State Description
APPROVED The transaction was approved.
CANCELLED The transaction was cancelled.

DECLINED

The transaction was declined.
ERROR The transaction did not go through as an error occurred.
UNKNOWN

The tender state is unknown, and it is not possible to determine it.

If you are using the TxStore feature, you can check the transaction result there. If not, you can check the transactions menu on the PED.