Issue 3rd Party Gift Card (#241) POS Key

This provides an overview of the Issue 3rd Party Gift Card (#241) POS Key used in conjunction with 3rd Party Interfaces. This POS Key can also be referred to as:

• Activate Gift Card
• Load Gift Card

---

Subjects      ▼

• What Is It Used For?
• What Is Supported?
• To Be Considered
• What is Required?
• Settings
• How Is It Used?
  • Blackhawk
  • Vii
  • Zen Global

---

What Is It Used For?      ▲ ▼

This can be used for activating/issuing/loading a 3rd Party Gift Card with an initial balance. For example, $50, $100, etc.

Refer to the How To Use 3rd Party Gift Cards for more information.

---

What Is Supported?      ▲ ▼

This function POS Key can be used in conjunction with the following 3rd Party Interfaces:

• Blackhawk
• Vii
• Zen Global

---

To Be Considered      ▲ ▼

• If required, access to this POS Key can be restricted by the Clerk Security feature.

---

What Is Required?      ▲ ▼

• Venues will need a NetPOS registration and the NetPOS settings will need to be configured for the appropriate 3rd Party Interface in order to use this function.
• Ensure this POS Key is added to the appropriate Keyboard Layout using the Designer. Refer to How To Add A POS Key To A Keyboard Layout for more information.
• Ensure it is configured as required. Refer to the Settings below.

---

Settings      ▲ ▼

• Vii Specific Settings
• Blackhawk Specific Settings
• Zen Global Specific Settings

---

Blackhawk Specific Settings      ▲ ▼

• Available Interfaces - Select from the drop down list the required Interface.

• Set/Change Selected Interface - Select to select the interface selected above and set the Selected Interface Type and Instance values.

• Enter number first - Select to ensure that the Gift Card/Voucher number is entered first. If not selected, entry for the Gift Card/Voucher number will be prompted as the end.

• Preset Amount - Displays/Enter the amount that will be used as the default amount to be loaded onto the Card.

OR

• Amounts - Select to open the Amounts screen (as depicted below) to configure up to 12 preset amounts. Once configured Clerks/Staff will be able to quickly select from one of the configured preset amounts when Issuing a Gift Card.

• Transaction Fee - Display/Set the amount that will be incurred in transaction fees each time an Activate Gift Card operation is completed.

• Product For Fee - Displays/Select the Product to which the Transaction Fee will be assigned to.

• Prompt for Original Reference ID - Select to ensure the prompt below is displayed, to facilitate the entry of the transactionUniqueId value when reversing a Blackhawk Activate Gift Card operation.

The transactionUniqueId value is sourced from the NetPOS log entry of the original transaction that is requiring to be reversed. For example:

0136 Blackhawk-1 LoadGiftCard: Response.
Body:
{"response":{"header":{"signature":"BHNUMS","details":{"productCategoryCode":"01","statusCode":"00","specVersion":"46"}},"transaction":{"primaryAccountNumber":"9877890000000000","processingCode":"725400","transactionAmount":"000000002500","transmissionDateTime":"230321045739","systemTraceAuditNumber":"002287","localTransactionTime":"145739","localTransactionDate":"230321","merchantCategoryCode":"5411","pointOfServiceEntryMode":"031","transactionFeeAmount":"000000000000","acquiringInstitutionIdentifier":"60300013772","retrievalReferenceNumber":"638150074597","authIdentificationResponse":"123456","responseCode":"00","merchantTerminalId":"00003 003 ","merchantIdentifier":"60300013772 ","transactionCurrencyCode":"036","additionalTxnFields":{"productId":"07675004390","balanceAmount":"C000000002500","transactionUniqueId":"SZT0614S9Z3ZTW04QT2VMJT3S8","correlatedTransactionUniqueId":"SZT0614S9Z3ZTW04QT2VMJT3S8","paymentDetails":{"paymentDetail1":{"tenderType":"Cash","paymentMode":"011"}}}}}}

In the above example the value of "SZT0614S9Z3ZTW04QT2VMJT3S8 would need to be entered into the prompt above.

---

Vii Specific Settings      ▲ ▼

This screen is accessed by selecting the More Settings button in Keyboard Designer.

• Available Interfaces - Select from the drop down list the required Interface.

• Set/Change Selected Interface - Select to select the interface selected above and set the Selected Interface Type and Instance values.

• Enter number first - Select to ensure that the Gift Card/Voucher number is entered first. If not selected, entry for the Gift Card/Voucher number will be prompted as the end.

• Preset Amount - Displays/Enter the amount that will be used as the default amount to be loaded onto the Card.

OR

• Amounts - Select to open the Amounts screen (as depicted below) to configure up to 12 preset amounts. Once configured Clerks/Staff will be able to quickly select from one of the configured preset amounts when Issuing a Gift Card.

---

Zen Global Specific Settings      ▲ ▼

• Available Interfaces - Select from the drop down list the required Interface.

• Set/Change Selected Interface - Select to select the interface selected above and set the Selected Interface Type and Instance values.

• Preset Amount - Displays/Enter the amount that will be used as the default amount to be loaded onto the Card.

OR

• Amounts - Select to open the Amounts screen (as depicted below) to configure up to 12 preset amounts. Once configured Clerks/Staff will be able to quickly select from one of the configured preset amounts when Issuing a Gift Card.

• Prompt for eMail Address - Select to ensure a prompt is displayed for the entry of an Email address. This option is MANDATORY when configuring the POS Key to Issue/Sell Digital Gift Cards.

• Voucher/Gift Card Type - Displays/Enter the text Gift. This is MANDATORY when configuring the POS Key to Issue/Sell Digital Gift Cards.

End of article.      ▲