Tender Definitions

The POS application gives retailers the flexibility to control and configure specific tenders.

The Tender Definitions parameter group includes records for the following tender types:

The following table describes the Tender Definitions options.

Note

This is a multi-record option group. Records can be added as necessary. This parameter group has a maximum limit of 999 records.

Option nameValueDescription
Active TenderYes/NoDetermines whether or not the tender is available for any functions.
Allow Demographic Fields PromptingOne or more of the following values:
  • Email Address
  • Telephone number
  • Zip code
Specifies the demographic information configured for a tender type.
Note

For partial tenders, only the demographic information that is configured for all the applied tenders are prompted.

Allow Under TenderYes/NoDetermines whether or not the tender must cover the outstanding balance.
Allowed As Refund (Not Original Tender)Yes/NoDetermines whether or not the tender is allowed to be distributed for refund when there is no original tender.
Note

This parameter is supported for Send Check tenders.

Allowed in Associate SaleYes/NoDetermines whether or not the tender type can be used in a sale transaction applied with an associate discount.
Authorization Merchant IDAn alphanumeric value from zero to 20 charactersSpecifies the merchant ID that would be printed on the chit when authorization is needed but the POS is offline to the authorizer.
Authorization Payment TypeAn alphanumeric value from zero to 40 charactersIdentifies the payment type to control authorization for this tender type. This parameter works in conjunction with the value configured in the Payment Type field in Payment Authorization. The value determines which payment client to use per tender.
Authorization Phone NumberA numeric value from zero to 9999999999

Determines whether or not the POS application displays the Call Credit Department screen and prints a chit when authorization is required but the POS is offline to the payment client.

When the value for this parameter is set, the POS application displays the Call Credit Department screen. When the value is left blank, the POS application displays the Unable to Process Card screen or an information message.

Collect General InfoAn alphanumeric value from zero to 40 charactersDescribes a general prompt scheme for this tender type. This parameter works in conjunction with the value configured in the Prompt Set ID field in Information Form Definitions.
Collect Info for Automatic EntryAn alphanumeric value from zero to 40 charactersDefines the prompt scheme for this tender type for automatic entry.
Collect Info for Integrated Chip EntryAn alphanumeric value from zero to 40 charactersDefines the prompt scheme for tender type for integrated chip entry.
Note

This parameter is not yet supported for Credit tenders.

Collect Info for Keyed EntryAn alphanumeric value from zero to 40 charactersDefines the prompt scheme for this tender type for keyed entry.
Collect Info for Micr EntryAn alphanumeric value from zero to 40 charactersDefines the prompt scheme for this tender type for Micr entry.
Collect Info for MSR EntryAn alphanumeric value from zero to 40 charactersDefines the prompt scheme for this tender type for MSR entry.
Collect Info for Scanned EntryAn alphanumeric value from zero to 40 charactersDefines the prompt scheme for this tender type for scanned entry.
Currency CodeA drop-down list.Defines the three-character currency code for this tender.
Drawer ControlYes/NoDetermines whether or not the tender requires the drawer.
Exchange RateA numeric value from zero to 40 digits.Specifies the exchange rate. This is calculated by comparing one unit of foreign currency to local currency.
Note

There will be a decimal point in the expected value when it is not in the local currency.

Is Auto PostedYes/NoControls if the system tender count automatically pre-populates the associate tender count values when counting the till.
Is Local CurrencyYes/NoDetermines whether or not the tender is the primary currency definition.
Is Mid Void AllowedYes/NoDetermines whether or not the tender is available to be mid-voided.
Is Post Void Allowed Yes/NoDetermines whether or not the tender is available to be post-voided.
Masking DefinitionAn alphanumeric value from zero to 40 charactersDefines the masking scheme to use for this tender. The value used in this parameter must match the value defined in the Masking Definition ID parameter in Masking Definitions.
Offline Sale Floor LimitAn alphanumeric value from zero to nine charactersSpecifies the amount to allow offline approval for this tender type.
Note

For Gift Card-type tenders, when this parameter is left blank, the POS application prompts for authorization. When this parameter has a value of 0, authorization is not an option. Other values may not be used for a floor limit with Gift Card Tender.

Overtender Maximum AmountA numeric value from zero to 99999999 charactersDetermines if over tendering is allowed and sets any limit on the amount.
POSLog SubTender TypeAn alphanumeric value from zero to 20 characters
Note

This value can include a colon (:) and a period (.).

Determines the value to display as the SubTenderType in the POSLog.
Note

This value is required. If the value is not in the ARTS schema, use an extension, for example, ncr:. Values cannot begin or end with a colon or period.

Sample value:

ncr:MerchandiseCard

POSLog Tender TypeAn alphanumeric value from one to 20 characters
Note

This value can include a colon (:) and a period (.).

Determines the value to display as the Tender Type in the POSLog.
Note

If the value is not in the Association for Retail Technology Standards (ARTS) schema, use an extension, for example, ncr:. Values cannot begin or end with a colon or period.

Sample value:

ncr:GiftCard

Print Post Void Customer Chit Yes/NoDetermines whether or not the customer chit should be printed for this tender type when a transaction is post voided.
Print Refund Audit CopyYes/NoDetermines whether or not to print the Return Audit copy when this tender is in the refund tenders and Print Audit Copy is set to Yes in Returns Setup.
Prompt For CVVYes/NoDetermines whether or not the CVV should be prompted for this tender type when hand-keyed.
Prompt For Last 4Yes/NoDetermines whether or not the last four digits of the account number is to be prompted for when this tender type is used in a sale.
Refund Tender IDA numeric value from zero to 40 digitsIdentifies the tender ID assigned to distribute as a refund in a return.
Refundable Original TenderYes/NoDetermines whether or not the original tender can be used for distribution as a refund.
Note

Foreign currencies, checks, and other media tenders are not supported refundable tenders.

Require PINYes/NoDetermines whether or not the PIN entry is required for this tender type when manually entered.
Note

When this option is set to No, the Entry Method Prompt for PIN parameter is disregarded. For information about the Entry Method Prompt for PIN parameter, refer to Gift Card Types.

Signature ControlYes/NoDetermines whether or not a signature line is printed on receipt for this tender type.
Signature ThresholdAn numeric value from zero to 999999999Specifies the maximum amount used to identify threshold for forgoing a signature.
Tender Button Display ControlA numeric value from zero to 99Controls the display order of the tender on menus.
Tender Button Display Option

One of the following values:

  • TenderName
  • TenderSubType
  • TenderButtonDisplaySequence
Determines whether the tender is grouped and displayed under the defined method TenderName or TenderSubType or TenderButtonDisplaySequence.
Note

TenderButtonDisplaySequence supports Credit Tenders only. For more information, refer to Charge tender types.

Tender Button Display SequenceA numeric value from zero to 99Groups Credit Tenders in a single button and displays it on the Tender Menu screen. The value for this parameter will display as the button name unless configured. For more information, refer to Grouping tenders
Note

The Credit Tenders must have the same value for this parameter record.

Tender IDA numeric value from zero to 999 characters

Specifies the ID for this tender.

This parameter is the record's key.

Tender Legal TextAn alphanumeric value from zero to 255 charactersThe legal text is printed on the store copy receipt when tendering with credit.
Tender Mid Void OptionOriginal Tender/Local CurrencyDetermines whether the original tender or the local currency is distributed for a mid-void.
Tender NameAn alphanumeric value from zero to 40 charactersDescribes the tender name used in the Tender Menu Display, Receipt, Hard Totals, and PosLog.
Tender Post Void OptionOriginal Tender/Local CurrencyDetermines whether the original tender or the local currency is distributed for a post-void.
Tender Sub TypeOne of the following values:
  • Cash
  • Foreign Currency
  • Credit
  • Debit
  • Gift Card
  • Check
  • Manual EFT
  • Online Payment
  • Customer Account
  • Loyalty Reward
  • Traveler’s Check
  • Manufacturer Coupon
  • Accounts Receivable
  • House Account
  • Gift Certificate
  • Coupon
Specifies the sub-type for this tender.
Tender TypeA drop-down list:
  • Currency
  • Charge
  • Media
  • Loyalty
Specifies the type of tender.
Valid For Tax Exempt TransactionYes/NoDetermines whether or not the tender is valid for tax exempt transactions.
Valid Transaction TypesOne or more valid transaction typesSpecifies the transaction types that are valid for this tender.
Validation SchemeAn alphanumeric value from zero to 40 charactersSpecifies the defined validation scheme for account/ reference ID for this tender type. This parameter works in conjunction with the value configured in the Validation Scheme ID field in Validation Definitions.