Creating ValueLink Operations Buttons

You need to add a button to POS Operations for each supported ValueLink Processor operation to function on the workstation. Each button needs to be set to the Function Run Extensibility App.

The following table lists the ValueLink operations (button names), descriptions, and argument strings that are used in the Page Design module. You will use this information in the subsequent steps.

Table 37-7 ValueLink Operation Buttons

Operation Name Description Argument String

Activate

Activate a gift card.

type=dll;appname=XProcessor;filename=ValueLink2.dll;script=Activate;arg=<XProcessorArgs><AccountEntryRules title="Activate" prompt="Enter name or swipe card" entrytype="String" allowmanual="true" allowbarcode="true" allowmagcard="true" allowmicrosemployeecard="false" allowfingerprint="false" maskentry="false"/></XProcessorArgs>

Denominated Activate or Activate Denominated

Activate a denominated gift card.

type=dll;appname=XProcessor;filename=ValueLink2.dll;script=denominated_activate;arg=<XProcessorArgs><AccountEntryRules title="Activate" prompt="Enter name or swipe card" entrytype="String" allowmanual="true" allowbarcode="true" allowmagcard="true" allowmicrosemployeecard="false" allowfingerprint="false" maskentry="false"/></XProcessorArgs>

Activate on Hold

Activate a gift card and change its status to “On Hold” until payment is made.

type=dll;appname=XProcessor;filename=ValueLink2.dll;script=ActivateOnHold;arg=<XProcessorArgs><AccountEntryRules title="Activation on Hold" prompt="Enter name or swipe card" entrytype="String" allowmanual="true" allowbarcode="true" allowmagcard="true" allowmicrosemployeecard="false" allowfingerprint="false" maskentry="false"/></XProcessorArgs>

Denominated Activate On Hold or Activate On Hold Denominated

Activate a denominated gift card and change its status to “On Hold” until payment is made.

type=dll;appname=XProcessor;filename=ValueLink2.dll;script=denominated_ActivateOnHold;arg=<XProcessorArgs><AccountEntryRules title="Activation on Hold" prompt="Enter name or swipe card" entrytype="String" allowmanual="true" allowbarcode="true" allowmagcard="true" allowmicrosemployeecard="false" allowfingerprint="false" maskentry="false"/></XProcessorArgs>

Activation Return

Reverse a gift card activation. This function does not require access to the original check, unlike a touch void.

type=dll;appname=XProcessor;filename=ValueLink2.dll;script=Activation_Return;arg=<XProcessorArgs><AccountEntryRules title="Activation Return" prompt="Enter name or swipe card" entrytype="String" allowmanual="true" allowbarcode="true" allowmagcard="true" allowmicrosemployeecard="false" allowfingerprint="false" maskentry="false"/></XProcessorArgs>

Authorize

Authorize the use of a card for payment. This function is used in conjunction with Finalize

type=dll;appname=XProcessor;filename=ValueLink2.dll;script=authorize;arg=<XProcessorArgs transactionstate="inside"><AccountEntryRules title="Authorize" prompt="Enter name or swipe card" entrytype="String" allowmanual="true" allowbarcode="true" allowmagcard="true" allowmicrosemployeecard="false" allowfingerprint="false" maskentry="false"/></XProcessorArgs>

Batch Activate

Activate multiple gift cards.

type=dll;appname=XProcessor;filename=ValueLink2.dll;script=BatchActivate;arg=<XProcessorArgs><AccountEntryRules title="Batch Activate" prompt="Enter name or swipe card" entrytype="String" allowmanual="true" allowbarcode="true" allowmagcard="true" allowmicrosemployeecard="false" allowfingerprint="false" maskentry="false"/></XProcessorArgs>

Cash Out

Remove the remaining balance of the gift card as a cash payment.

type=dll;appname=XProcessor;filename=ValueLink2.dll;script=cashout;arg=<XProcessorArgs transactionstate="outside"><AccountEntryRules title="Cash Out" prompt="Enter name or swipe card" entrytype="String" allowmanual="true" allowbarcode="true" allowmagcard="true" allowmicrosemployeecard="false" allowfingerprint="false" maskentry="false"/></XProcessorArgs>

Finalize

Use the gift card as payment. This function is used in conjunction with Authorize.

type=dll;appname=XProcessor;filename=ValueLink2.dll;script=finalize;arg=<XProcessorArgs suppressaccountprompt="true" selectpendingoperation="true" transactionstate="inside"><AccountEntryRules title="Finalize" prompt="Enter name or swipe card" entrytype="String" allowmanual="true" allowbarcode="true" allowmagcard="true" allowmicrosemployeecard="false" allowfingerprint="false" maskentry="false"/></XProcessorArgs>

Inquire

Retrieve the current balance of a gift card.

type=dll;appname=XProcessor;filename=ValueLink2.dll;script=Inquire;arg=<XProcessorArgs><AccountEntryRules title="Inquire" prompt="Enter name or swipe card" entrytype="String" allowmanual="true" allowbarcode="true" allowmagcard="true" allowmicrosemployeecard="false" allowfingerprint="false" maskentry="false"/></XProcessorArgs>

Redeem

Use the gift card as payment.

type=dll;appname=XProcessor;filename=ValueLink2.dll;script=Redeem;arg=<XProcessorArgs transactionstate="inside"><AccountEntryRules title="Redeem" prompt="Enter name or swipe card" entrytype="String" allowmanual="true" allowbarcode="true" allowmagcard="true" allowmicrosemployeecard="false" allowfingerprint="false" maskentry="false"/></XProcessorArgs>

Refund

Add value to an active gift card via a return.

type=dll;appname=XProcessor;filename=ValueLink2.dll;script=Refund;arg=<XProcessorArgs transactionstate="inside"<AccountEntryRules title="Refund" prompt="Enter name or swipe card" entrytype="String" allowmanual="true" allowbarcode="true" allowmagcard="true" allowmicrosemployeecard="false" allowfingerprint="false" maskentry="false"/></XProcessorArgs>

Reload

Add value to an active gift card via a payment.

type=dll;appname=XProcessor;filename=ValueLink2.dll;script=Reload;arg=<XProcessorArgs><AccountEntryRules title="Reload" prompt="Enter name or swipe card" entrytype="String" allowmanual="true" allowbarcode="true" allowmagcard="true" allowmicrosemployeecard="false" allowfingerprint="false" maskentry="false"/></XProcessorArgs>

Reload on Hold

Add value to an active gift card and change its status to “On Hold” until payment is made.

type=dll;appname=XProcessor;filename=ValueLink2.dll;script=ReloadOnHold;arg=<XProcessorArgs><AccountEntryRules title="Reload on Hold" prompt="Enter name or swipe card" entrytype="String" allowmanual="true" allowbarcode="true" allowmagcard="true" allowmicrosemployeecard="false" allowfingerprint="false" maskentry="false"/></XProcessorArgs>

Remove on Hold Status

Manually remove a card’s “On Hold” status.

type=dll;appname=XProcessor;filename=ValueLink2.dll;script=RemoveOnHoldStatus;arg=<XProcessorArgs><AccountEntryRules title="Remove on Hold Status" prompt="Enter name or swipe card" entrytype="String" allowmanual="true" allowbarcode="true" allowmagcard="true" allowmicrosemployeecard="false" allowfingerprint="false" maskentry="false"/></XProcessorArgs>

Void Cash Out

Reverse a previously performed cash out operation.

type=dll;appname=XProcessor;filename=ValueLink2.dll;script=void_cashout;arg=<XProcessorArgs transactionstate="outside"><AccountEntryRules title="Void Cash Out" prompt="Enter name or swipe card" entrytype="String" allowmanual="true" allowbarcode="true" allowmagcard="true" allowmicrosemployeecard="false" allowfingerprint="false" maskentry="false"/></XProcessorArgs>

Transaction Cancel

Prompt a workstation operator to void any existing gift card operations when attempting to cancel a transaction.

type=DLL;Appname=XProcessor;FileName=TransCancelExt.dll;
  1. Select the Enterprise, property, or revenue center, click Configuration, and then click Page Design.
  2. Open the page on which to place ValueLink Processor buttons.
  3. On the Edit tab, select the page area in which to define the ValueLink Processor functions.
  4. Click Button.
  5. On the General subtab, in the Legend field, enter the operation name (button).
  6. Select Function from the Type drop-down list.
  7. Click the black arrow beneath the Type drop-down list.
  8. Select Extensibility from the Type pane, select Run Extensibility App in the Results pane, and then click OK.
  9. Click inside the Arguments field (left of the black arrow). The easiest way to complete this field for each operation name is to copy and paste the information from the table in the Arguments String field.

    Ensure that there are no spaces within the string.

  10. Repeat steps 4 through 9 to create buttons for each of the ValueLink operations listed in the table.
  11. Click Save.

Parent topic: ValueLink Processor