Terminal-2 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 POS app 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 in your POS app to keep your staff up-to-date on the progress of the transaction.

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

In-progress tender states

State

Description

ACCOUNT_TYPE_SELECTED

The shopper has selected their preferred account type.

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 shopper has selected their preferred payment application.

ASK_CHARITY

The terminal is waiting for a possible donation.

ASK_DCC

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

ASK_GRATUITY

The terminal is waiting for a possible gratuity.

ASK_SIGNATURE

The terminal 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.

CANCEL_OR_REFUND_COMPLETED

The cancellation or refund has completed.

CARD_ACQ_COMPLETED

The terminal has acquired the card details.

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 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_PRESENTED

The shopper has presented the card to the terminal's contactless reader.

CARD_REMOVED

A card was removed from the terminal.

CARD_SWIPED

A card was swiped.

CHARITY_ENTERED

The shopper responded to the donation prompt.

CHECK_SIGNATURE

The terminal is waiting for the cashier to approve or decline the signature.

DCC_ACCEPTED

The shopper accepted Dynamic Currency Conversion.

DCC_REJECTED

The shopper rejected Dynamic Currency Conversion.

GRATUITY_ENTERED

The gratuity amount was entered.

INITIAL

A transaction was initiated.

LOAD_COMPLETED

Loading a value on the card has completed.

LOAD_STARTED

Loading a value on the card has started.

PIN_ENTERED

The whole PIN was entered.

PRINT_RECEIPT

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

TENDER_FINAL

The tender was completed.

WAIT_FOR_ACCOUNT_TYPE_SELECTION

The terminal is waiting for the shopper to select an account type.

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.

Tender result

StateDescription
APPROVEDThe transaction was approved.
CANCELLEDThe transaction was cancelled.
DECLINEDThe transaction was declined.
ERRORThe transaction did not go through as an error occurred.
UNKNOWN

Specific to library integrations. 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