AIMStorefront can process orders placed with physical Gift Cards purchased from your brick and mortar store. Please review all steps of this article before attempting to configure your site to use AIM Gift Cards


AIM v12. C2B machine required.

Here's how it works: 

Turn on Gift Cards in the website.

To turn on the feature, in /aesys go to "Settings" and search for "Edition.AeGiftCardsEnabled". Change this setting to "True" and refresh your store. 

*Enabling this (true) disables legacy Gift Cards. Your site cannot support both AIM Gift Cards and legacy Gift Cards at once.

Enter your Cards into AIM. 

When you receive your physical Gift Cards to sell in the store, you'll need to enter them into your AIM system by following the Tri-Tech manual page HERE. If you have questions involving getting your gift card numbers into AIM, you'll need to contact Tri-Tech support at 1-563-556-3556 (Option 2). Most AIM users will scan their cards into the system, but they can be entered manually.

In this example, we're going to start our gift card numbers with an example number of EGC000000000066 and enter 20 Cards:

*We are using an example number in our instructions. Please do not use this number in your AIM and expect it to work.

After entering the cards' starting number and the number of cards I have, I hit "Save". 

It will ask, "are you sure?" 

I answer, "yes."

Turning on the PIN

In order to use a gift card online, each customer will need to know the "PIN" associated with their gift card. They will get the PIN from the receipt you print when the card is purchased. 

In AIM, go to "Maintenance > General > System Variables". In configuration item, in the "Contains:" field, enter "PIN". Select PrintGiftCardPIN and enable it. This will make sure that the PIN is printed on the customer’s receipt. 

Selling your Gift Cards

When you sell the Gift Cards in your store, You will scan the card or enter it through POS. The customer's PIN will be printed on the receipt. Please contact Tri-Tech support if you have any questions about how to sell Gift Cards in your store please contact Tri-Tech support at 1-563-556-3556 (Option 2).

*We are using an example number in our instructions. Please do not use this number in your AIM and expect it to work. 

Using the card for online payment. 

When a customer with a Gift Card goes shopping on your website, and they reach the final e-commerce checkout page, they will now see a spot to enter their Gift Card number and PIN right below the payment methods. Customers can check their balance and apply part or all of the Gift Card balance to the order. 

*We are using an example number in our instructions. Please do not use this number in your AIM and expect it to work. 

Manually editing Gift Cards

In "Modules > Inventory > Add/Change Inventory > E-Card Maintenance", you should see the list of Gift Cards in your inventory. If you select the card on the left, you can see the Card#, as well as the balance on the right. You can adjust the Original Card amount to the corrected amount and save the card. It is now ready to use in your store and online with the updated balance.

*We are using an example number in our instructions. Please do not use this number in your AIM and expect it to work. 

Existing App Configs

  • GiftCards.Enabled - Must be set to true to enable any Gift Card support in checkout (Legacy or AIM). By default, uses ASPDNSF legacy Gift Cards.

New App Configs

  • Edition.AeGiftCards.Enabled- Enable true to allow AIM Gift Cards. 
    • Enabling this (true) disables legacy Gift Cards. We do not support both styles of Gift Cards at once in this iteration of the feature.

New Prompts

  • Edition.AeGiftCard.Apply  Default: Apply  - Label for the button that applies your gift card to the cart total in checkout.
  • Edition.AeGiftCard.Error.Balance.APIFailure  Default: We could not retrieve your gift card balance. Please make sure your gift card number and pin are correct. - Displayed when there is an API failure retrieving the balance.
  • Edition.AeGiftCard.Error.CardNotFound  Default: Card Not Found - Displayed when the card information is invalid and the shopper tries to check the balance.
  • Edition.AeGiftCard.Error.Charge.APIFailure  Default: We could not charge your gift card. Please make sure your gift card number, pin, and charge amount are correct. - Displayed for an API failure charging the card.
  • Edition.AeGiftCard.Error.Charge.MissingInfo  Default: We could not charge your gift card. Please make sure you have entered the gift card number, pin, and charge amount.Displayed for invalid characters and unexpected data (whitespace, weirdness) in the gift card number and Pin fields.
  • Edition.AeGiftCard.Error.Data  Default: We are unable to accept your Gift Card. Please make sure the information you have entered is correct. - Displayed for unexpected, rare errors that occur due to an invalid AIM connection.
  • Edition.AeGiftCard.Header  Default: Gift Card - Used for the header of AIM Gift Cards in checkout.
  • Edition.AeGiftCard.Label.ChargeAmount  Default: Amount to Charge - Label for the amount which the customer wants to charge from their card during checkout.
  • Edition.AeGiftCard.Label.CheckBalanceButton  Default: Check Card BalanceLabel for the button to check the current balance of the entered gift card number and pin.
  • Edition.AeGiftCard.Label.Checkbox  Default: Pay up to my full balance - Label for a checkbox which allows the customer to "fire and forget" their Gift Card, charging the maximum balance possible/needed for the order.
  • Edition.AeGiftCard.OrderNotes  Default: AIM Gift Card # - Displayed in the order notes after successful checkout. This allows you to track which AIM Gift Card was used for payment of an order.
  • Edition.AeGiftCard.Placeholder.Pin  Default: Pin - The PIN required for charging a Gift Card.
  • Edition.AeGiftCard.Placeholder.Serial  Default: Serial - The gift card number value required for charging a gift card.

Gift Card Processing NOTES

  • When performing a REFUND on an order that used a Gift Card, the funds are not automatically allocated back to the Gift Card, in either AIM or the cart. You will need to note the code used on the order (edit the order in aesys, expand the "Order XML" box lower right, search for "couponcode" and copy the value between the tags to your clipboard, ex.  <CouponCode>e1d90e01-3961-4fab-a8e0-41d68d33a5be</CouponCode>), then access the Gift Card to "Add Funds" back to it.
    • In the CART aesys, go to Configuration - Manage Gift Cards - paste the copied value into the gift card number  field, click Apply Filter, click the "USAGE" link, Select "Add Funds" from the drop-down, enter the amount to refund, enter the Order Number, click "Add Usage".
    • In AIM, locate the Gift Card and Refund the amount manually.