Creating Givex Processor Operations Buttons

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

The following tables list the operations supported by the Givex Processor and the arguments that are used in the Page Design module. The first table lists button arguments that support account numbers less than 9,223,372,036,854,775,807. Customer sites with account numbers greater than this number must use the button arguments listed in the second table. Use the information from these tables in the subsequent steps.

Table 37-1 Givex Operation Buttons — Original

Operation Name	Description	Argument String
Activate	Activate a gift card. Used to activate both denominated and non-denominated cards.	Type=DLL;AppName=XProcessor;FileName=Micros.XProcessor.dll;Script=Activate
Authorize	Authorize the use of a gift card for payment. This function is used in conjunction with Finalize.	Type=DLL;AppName=XProcessor;FileName=Micros.XProcessor.dll;Script=Authorize;Arg=<XProcessorArgs transactionstate="inside" />
Balance Transfer	Transfer the balance of one card to another. The source card effectively becomes inactive.	Type=DLL;AppName=XProcessor;FileName=Micros.XProcessor.dll;Script=BalanceTransfer;Arg=<XProcessorArgs transactionstate="outside"><AccountEntryRules title="Givex Balance Transfer" prompt="Enter Account Number to Transfer Balance To" entrytype="Numeric" allowmanual="true" allowbarcode="true" allowmagcard="true" allowmicrosemployeecard="false" allowfingerprint="false" maskentry="false" /></XProcessorArgs>
Batch Activate	Activate multiple gift cards.	Type=DLLl;AppName=XProcessor;FileName=Micros.XProcessor.dll;Script=BatchActivate;Arg=<XProcessorArgs processorid="msvc-givex" suppressaccountprompt="true" />
Cash Out	Remove the remaining balance of the gift card.	Type=DLL;AppName=XProcessor;FileName=Micros.XProcessor.dll;Script=Cashout;Arg=<XProcessorArgs transactionstate="outside" />
Finalize	Finalize the gift card payment. This function is used in conjunction with Authorize.	Type=DLL;AppName=XProcessor;FileName=Micros.XProcessor.dll;Script=Finalize;Arg=<XProcessorArgs suppressaccountprompt="true" selectpendingoperation="true" transactionstate="inside"/>
Inquire	Retrieve the current balance of a gift card.	Type=DLL;AppName=XProcessor;FileName=Micros.XProcessor.dll;Script=Inquire
Issue	Generate a new card number with the requested balance. Does not activate an existing card. Instead, a new account number is generated with the requested balance (essentially an e-Gift card)	Type=DLL;AppName=XProcessor;FileName=Micros.XProcessor.dll;Script=Issue;Arg=<XProcessorArgs processorid="msvc-givex" suppressaccountprompt="true" />
Redeem	Use the gift card as payment.	Type=DLL;AppName=XProcessor;FileName=Micros.XProcessor.dll;Script=Redeem;Arg=<XProcessorArgs transactionstate="inside" />
Reload	Givex cards are activated by the Reload operation. Used to activate both denominated and non-denominated cards Add value to an active gift card via a payment.	Type=DLL;AppName=XProcessor;FileName=Micros.XProcessor.dll;Script=Reload
Void Cash Out	Reverse a previously performed cash out operation.	Type=DLL;AppName=XProcessor;FileName=Micros.XProcessor.dll;Script=void_cashout;Arg=<XProcessorArgs transactionstate="outside" />

Table 37-2 Givex Operation Buttons — Supports 19+ Digit Account Numbers

Operation Name	Description	Argument String
Activate	Activate a gift card. Used to activate both denominated and non-denominated cards.	Type=DLL;AppName=XProcessor;FileName=Micros.XProcessor.dll;Script=Activate;Arg=<XProcessorArgs><AccountEntryRules title="Activate" prompt="Enter Account Number" entrytype="String" allowmanual="true" allowbarcode="true" allowmagcard="true" allowmicrosemployeecard="false" allowfingerprint="false" maskentry="false" /></XProcessorArgs>
Authorize	Authorize the use of a gift card for payment. This function is used in conjunction with Finalize.	Type=DLL;AppName=XProcessor;FileName=Micros.XProcessor.dll;Script=Authorize;Arg=<XProcessorArgs transactionstate="inside"><AccountEntryRules title="Authorize" prompt="Enter Account Number" entrytype="String" allowmanual="true" allowbarcode="true" allowmagcard="true" allowmicrosemployeecard="false" allowfingerprint="false" maskentry="false" /></XProcessorArgs>
Balance Transfer	Transfer the balance of one card to another. The source card effectively becomes inactive.	Type=DLL;AppName=XProcessor;FileName=Micros.XProcessor.dll;Script=BalanceTransfer;Arg=<XProcessorArgs transactionstate="outside"><AccountEntryRules title="Givex Balance Transfer" prompt="Enter Account Number to Transfer Balance To" 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=Micros.XProcessor.dll;Script=BatchActivate;Arg=<XProcessorArgs processorid="msvc-givex" suppressaccountprompt="true" />
Cash Out	Remove the remaining balance of the gift card.	Type=DLL;AppName=XProcessor;FileName=Micros.XProcessor.dll;Script=Cashout;Arg=<XProcessorArgs transactionstate="outside"><AccountEntryRules title="Cashout" prompt="Enter Account Number" entrytype="String" allowmanual="true" allowbarcode="true" allowmagcard="true" allowmicrosemployeecard="false" allowfingerprint="false" maskentry="false" /></XProcessorArgs>
Finalize	Finalize the gift card payment. This function is used in conjunction with Authorize.	Type=DLL;AppName=XProcessor;FileName=Micros.XProcessor.dll;Script=Finalize;Arg=<XProcessorArgs suppressaccountprompt="true" selectpendingoperation="true" transactionstate="inside"/>
Inquire	Retrieve the current balance of a gift card.	Type=DLL;AppName=XProcessor;FileName=Micros.XProcessor.dll;Script=Inquire;Arg=<XProcessorArgs><AccountEntryRules title="Inquire" prompt="Enter Account Number" entrytype="String" allowmanual="true" allowbarcode="true" allowmagcard="true" allowmicrosemployeecard="false" allowfingerprint="false" maskentry="false" /></XProcessorArgs>
Issue	Generate a new card number with the requested balance. Does not activate an existing card. Instead, a new account number is generated with the requested balance (essentially an e-Gift card)	Type=DLL;AppName=XProcessor;FileName=Micros.XProcessor.dll;Script=Issue;Arg=<XProcessorArgs processorid="msvc-givex" suppressaccountprompt="true" />
Redeem	Use the gift card as payment.	Type=DLL;AppName=XProcessor;FileName=Micros.XProcessor.dll;Script=Redeem;Arg=<XProcessorArgs transactionstate="inside"><AccountEntryRules title="Redeem" prompt="Enter Account Number" entrytype="String" allowmanual="true" allowbarcode="true" allowmagcard="true" allowmicrosemployeecard="false" allowfingerprint="false" maskentry="false" /></XProcessorArgs>
Reload	Givex cards are activated by the Reload operation. Used to activate both denominated and non-denominated cards Add value to an active gift card via a payment.	Type=DLL;AppName=XProcessor;FileName=Micros.XProcessor.dll;Script=Reload;Arg=<XProcessorArgs><AccountEntryRules title="Reload" prompt="Enter Account Number" 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=Micros.XProcessor.dll;Script=void_cashout;Arg=<XProcessorArgs transactionstate="outside"><AccountEntryRules title="Void Cashout" prompt="Enter Account Number" entrytype="String" allowmanual="true" allowbarcode="true" allowmagcard="true" allowmicrosemployeecard="false" allowfingerprint="false" maskentry="false" /></XProcessorArgs>

Select the Enterprise, property, or revenue center, click Configuration, and then click Page Design.
Open the page on which to place the Givex Processor buttons.
On the Edit tab, select the page area in which to define the Generic SVC Processor functions.
Click Button.
On the General subtab, in the Legend field, enter the operation name (button).
Select Function from the Type drop-down list.
Click the black arrow beneath the Type drop-down list.
Select Extensibility from the Type pane, select Run Extensibility App in the Results pane, and then click OK.
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.
Repeat steps 4 through 9 to create buttons for each of the operations listed in the table.
Click Save.

Parent topic: Givex Processor