Deducts funds from a gift card for the purchase of goods or services.
public void RedeemCard();
Public Sub RedeemCard()
A Redemption transaction is the process of deducting value from the Gift Card, and is very similar to a Credit Card Sale transaction, except that funds are immediately removed from the balance of the gift card. RedeemCard requests that the host verify and remove funds from the cardholder's Stored Value (Gift) Card. This transaction is automatically added to the current open batch, and will be settled when the PTechHostSettle component's BatchRelease method is called.
The gift card may be specified by either a MagneticStripe returned by a card reader, (Track2 only), or manually entered through the Number, ExpMonth, and ExpYear.A 3-digit Card Verification Value code may also be supplied in the CVVData field.
The Code and Text fields indicate whether this transaction was successful. The host will return either an approval if the card has the requested value, or a decline if the card has less than the requested value.
If the merchant allows it, at the time of purchase a customer my Cash Out his gift card, and receive the remainder of the gift card's stored value as cash. To cash out a gift card, set the CashOutIndicator to True before calling RedeemCard. The change to be returned to the customer (The gift card's total value minus the TransactionAmount) will be returned in CashOut, and the Balance will be "0.00".
In the case that the customer's gift card does not have enough funds to cover the entire TransactionAmount, the merchant may request that the host perform a Partial Redemption. With PartialRedemption set to True, the Point of Sale is capable of processing a Redemption transaction for more than the card balance and still receive an approval. All of the funds remaining on the gift card will be put towards the TransactionAmount, and the merchant will be required to obtain an additional form of payment for the remaining balance. The amount actually removed from the card will be returned in AuthorizedAmount, and the customer's receipt should indicate the remaining amount (TransactionAmount - AuthorizedAmount) due.
.NET Standard Notes
To call this method in an asynchronous manner call RedeemCardAsync instead. When the method completes (or an error is encountered) the RedeemCardCompleted event will fire.