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. You will use the information from these tables in the subsequent steps.

Table 48-1 Givex Operation Buttons — Original

Operation Name Description Argument String

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=&lt;XProcessorArgs transactionstate="outside">&lt;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" />&lt;/XProcessorArgs>

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.

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

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 48-2 Givex Operation Buttons — Supports 19+ Digit Account Numbers

Operation Name Description Argument String

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>

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.

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

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>
  1. Select the Enterprise, property, or revenue center, click Configuration, and then click Page Design.
  2. Open the page on which to place the Givex Processor buttons.
  3. On the Edit tab, select the page area in which to define the Generic SVC 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 operations listed in the table.
  11. Click Save.