Search

Are you looking for test card numbers?

Would you like to contact support?

Point-of-sale icon

Tender states

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

Looking for payment statuses?

Refer to Payments lifecycle for payment statuses like Received, Authorised, or Settled.

The tender is the entire process for the cash register to start the transaction, receive card information, make optional changes to the amount, await authorization, print the receipt, and receive a final status.

During the tender, payment terminals generate display notifications. You can present these on your cash register to keep your store staff up-to-date on the progress of the transaction.

In the next overviews, the in-progress tender state is the current state of the transaction while it is ongoing, and the final tender state is the state when the transaction is completed.

In-progress tender states

State

Description

ACCOUNT_TYPE_SELECTEDThe shopper has selected their preferred account type.
ACKNOWLEDGEDThe transaction is acknowledged, but not approved, declined, cancelled or failed in error.
ADDITIONAL_DATA_AVAILABLEAdditional data (like card alias (token), card type and issuer country code) are available.
APPLICATION_SELECTEDThe shopper has selected their preferred payment application.
APPROVEDThe transaction has been approved.
ASK_CHARITYThe terminal is waiting for a possible donation.
ASK_DCCThe terminal is checking if the shopper requires dynamic currency conversion.
ASK_GRATUITYThe terminal is waiting for a possible gratuity.
ASK_SIGNATUREThe terminal has requested a signature from the shopper.
BALANCE_QUERY_ACQUIREDConfirms the acquired balance and allows the user to take next steps.
BALANCE_QUERY_COMPLETEDThe request for card balance has completed.
BALANCE_QUERY_STARTEDThe terminal is requesting the balance on a card.
CANCEL_OR_REFUND_COMPLETEDThe cancellation or refund has completed.
CANCELLEDThe transaction was cancelled.
CARD_ACQ_COMPLETEDThe terminal has acquired the card details.
CARD_DETAILS_PROVIDEDThe card details have been entered.
CARD_INSERTEDA card was inserted.
CARD_METHOD_SELECTEDA card is presented to the terminal for a contactless/NFC transaction
CARD_MKE

The terminal 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_PRESENTEDThe shopper has presented the card to the terminal's contactless reader.
CARD_REMOVEDA card was removed from the terminal.
CARD_SWIPED

A card was swiped.

CHARITY_ENTEREDThe shopper responded to the donation prompt.
CHECK_SIGNATUREThe terminal is waiting for the cashier to approve or decline the signature.
DCC_ACCEPTEDThe shopper accepted Dynamic Currency Conversion.
DCC_REJECTEDThe shopper rejected Dynamic Currency Conversion.
DECLINEDThis 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.
ERRORThe transaction did not go through because an error occurred.
GRATUITY_ENTEREDThe gratuity amount was entered.
INITIALA transaction was initiated.
LOAD_COMPLETEDLoading a value on the card has completed.
LOAD_STARTEDLoading a value on the card has started.
PIN_DIGIT_ENTEREDA digit of the PIN was entered.
PIN_ENTEREDThe whole PIN was entered.
PRINT_RECEIPThe terminal is printing the receipt.
PROCESSING_TENDERThe payment is being processed. The terminal displays a progress bar.
PROVIDE_CARD_DETAILSThe terminal is waiting for card details.
RECEIPT_PRINTEDA receipt was printed.
REFERRALThe acquirer sends a referral status.
REFERRAL_CHECKEDThe referral code was checked.
SIGNATURE_CHECKEDThe cashier has checked and confirmed the signature.
TENDER_CREATEDThe tender was created successfully.
UNKNOWNThe 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 terminal.
WAIT_FOR_ACCOUNT_TYPE_SELECTIONThe terminal is waiting for the shopper to select an account type.
WAIT_FOR_AMOUNT_ADJUSTMENTWaiting for an amount to be adjusted based on the gratuity.
WAIT_FOR_APP_SELECTIONThe terminal is waiting for the shopper to select a payment application.
WAIT_FOR_PINA PIN is requested at the terminal.

Final tender states

StateDescription
APPROVEDThe transaction was approved.
CANCELLEDThe transaction was cancelled.
DECLINEDThe transaction was declined.
ERRORThe 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 terminal.

See also