TransactionInformationRedeem

Information about a gift card transaction in the Toast
platform that reduces the balance of funds available from the card. For example, when the gift card is used for a purchase. Gift card providers are expected to handle the transaction.

checkIdentifier
string

The unique identifier of the check that this gift card transaction is part of. No action needs to be taken based on this identifier, it is just provided for tracking purposes.

giftCardIdentifier
string

The unique identifier of the gift card.

identifierSource
string

Indicates how the Toast platform received the gift card identifier string. Values are:

  • KEYED - A restaurant employee or guest manually entered the identifier string.

  • SCANNED - A restaurant employee or guest used a barcode scanner or other scanning device to enter the identifier string.

  • SWIPED - A restaurant employee or guest used a magnetic card strip reader to enter the identifier string.

  • KEYED_ONLINE - The source of this transaction is Toast Online Ordering, The provider can reject the transaction regardless of the restaurant's verification code settings.

  • UNKNOWN - The Toast platform received the identifier string using a method other than KEYED, SCANNED, or SWIPED, or the method is not known.

Enum: "KEYED" "SCANNED" "SWIPED" "KEYED_ONLINE" "UNKNOWN"
isCashOut
boolean

True if this redeem transaction is a cash out transaction, false otherwise

redeemedValue
number <double>

The currency amount of the funds being redeemed from the gift card.

relatedTransaction
string

The Toast platform unique identifier for a previous gift card transaction. Your integration can use this identifier to confirm information about a previous, related transaction such as PIN verification. For example, if a restaurant employee adds a tip or gratuity to a transaction, the Toast POS reverses the initial redemption and sends another redemption with the new amount. This value provides the identifier of the initial transaction. If the current transaction is not part of an adjustment (for example, reversing a transaction) this value is null.

object

The verification code, also often referred to as a PIN code, for the gift card account. A verification code is an additional layer of security that some gift card providers include.

{
  • "giftCardIdentifier": "string",
  • "identifierSource": "KEYED",
  • "verificationCode": {
    },
  • "redeemedValue": 0,
  • "checkIdentifier": "string",
  • "isCashOut": true,
  • "relatedTransaction": "string"
}