### Configuring WorldPay Invisible Payment Plug-in

The WorldPay Invisible plug-in supports the WorldPay Select Invisible installation type, which allows processing sales silently in the background without your customers having to leave your website and being forwarded to the WorldPay payment page.

To use the Select Invisible installation, you need to have the WorldPay account set up and a subscription either for Select Junior or Select Pro installations.

The use of Select Invisible is not normally permitted for purchases, although all customers can use it for refunds and post-authorizations.

After you subscribe for Select Invisible installation, you will receive the unique Installation ID that must be entered into the HSPcomplete WorldPay Invisible plug-in configuration form.

The WorldPay Invisible plug-in implemented in HSPcomplete supports the following transaction types:

- 'Sale' - the single-step transaction without pre-authorization,
- 'Preauth' - the amount was reserved and the transaction was suspended till authorization,
- 'Capture' - the transaction was authorized and the reserved amount was withdrawn,
- 'PreAuthReversal' - the transaction was cancelled on the 'Preauth' stage,
- 'CaptureReversal' - the transaction was cancelled on the 'Capture' stage, but before the transaction was actually finished.
- 'Refund' - the amount withdrawn from a credit card was refunded.

Using pre-authorization and remote transactions finishing (i.e., post-authorization or automated funds capture.

Pre-authorization (Deferred Processing) gives you additional control over the completion of credit and debit card transactions. The pre-authorization process works as follows:

When a Shopper makes a purchase from your site, their card details are checked and the purchase transaction is authorized as normal but the transaction is set to a pre-authorized status. Although funds are reserved against the Shopper's card, the money is not debited at this point. Once you are satisfied and ready to ship the goods, you must complete or 'post-authorize' the transaction within 5 days to ensure that the funds are debited from the shopper and remitted to you.

Pre-authorization is not standard WorldPay functionality and must be requested and set up by WorldPay. Once Pre-authorization is enabled for your installation, you can check the Preauthorization enabled box in the HSPcomlete WorldPay Invisible plug-in to perform the Preauth-Capture transactions.

The WorldPay plug-in implemented in HSPcomplete allows setting the remote post-authorization of transactions. You will need to ask your local Technical Support team to set up your installation for this type of remote administration.

After the remote post-authorization is set up for your installation, you can enter into the WorldPay Invisible configuration form the post-authorization URL (into the Post-authorize URL field) and the time to be passed before the pre-authorized money must be captured from a credit card (into the Auto capture period field). Probably in this case your installation ID will change and you will need to enter this new ID into the WorldPay Invisible plug-in configuration form as well, so please ask your WorldPay Support representatives about this.

To activate your WorldPay installation:

1. Fill the WorldPay Invisible plug-in form following the instructions in the step-by-step instructions outlined later in this topic, but keep in mind the installation activation instructions below.
2. Perform the test transaction:
   1. Enter your test Installation ID into the Installation ID field and select Always approve from the Test mode drop-down menu. Fill the other fields and save changes.

      Note: The value in the Test mode field on the WorldPay plug-in form in HSPcomplete assigns a particular value to the testMode parameter passed to WorldPay and saying whether a transaction is trial or not. For your reference, we enlist the testMode values passed depending on the Test mode field value:

      testMode=101 if Always decline in the Test mode drop-down menu is selected, equivalent to a declined authorization at the bank but no funds transferred

      testMode=100 if Always approve in the Test mode drop-down menu is selected, equivalent to a successful authorisation at the bank but no funds transferred. To perform test transaction, you need testMode to be set to 100.

      testMode=0 if Off in the Test mode drop-down menu is selected, in this case a live transaction is sent to bank for the standard authorization process with resultant funds transfer if successful.

   2. Perform the test transaction using, for example, you can use one of the test credit card numbers offered at the WorldPay website.
3. Activate your Installation:
   1. Log in to the WorldPay Customer Management System (CMS) and select the Configuration options for your installation. Here you will need to enter your successful test transaction instructions and your website URL. Clicking the Save Changes button will confirm your intention to go live. WorldPay will send you a confirmation e-mail and when satisfied with your technical integration, will set your site live.

To configure the WorldPay Invisible plug-in:

1. Click the Edit button on the plug-in screen. Fill the form that appears.
   1. Type the WorldPay server URL into the Server URL field. This is the URL the transaction requests will be sent.
   2. Type the World Pay post-authorization URL into the Post-authorize URL field. The post authorization transaction actually charges a credit card and pays the merchant.
   3. Type your WorldPay Invisible Installation ID into the Installation ID field. For test mode, enter the test ID.
   4. If you have several accounts at WorldPay, you can indicate the ID of an account to be used for transactions from your HSPstore in the Preferred account ID field. As a general rule, WorldPay opens one account per currency that you process. The WorldPay system automatically selects an account suitable for processing each transaction, based on the plug-in working mode (testing or live) and the currency of the transaction. Preferred accounts become relevant when you have accounts with identical characteristics to be used for different purposes. For example, you may have one Euro (EUR) account for software sales and another for hardware sales. Payments submitted to WorldPay for software will need to specify the software account and similarly for hardware. If you do not specify which, then the WorldPay system selects whichever is found first in the database.
   5. Type the callback password you have specified in you WorldPay account configuration for the Callback URL into the Callback password field.
   6. Select at least one credit card type to be accepted by the plug-in from the Available credit card types menu. To select a credit card type to accept with the plug-in, click on a card type name and then click the >> button to move a card type to the Supported Card Types menu. To select several card types in series, hold down SHIFT, and then click the first and last card types of the group. To select several card types that are nonadjacent in the list, hold down CTRL, and click a credit card type.
   7. You can check the Preauthorization enabled box to perform transactions of the Preauth-Sale type. To perform the Sale transactions without money preauthorization on a credit card, leave this box clear.
   8. You can enable the automated capture of pre-authorized funds on a credit card. To this effect, into the Auto capture period field, enter the time (in hours) to be passed after funds are pre-authorized till funds are to be automatically captured. Zero value in this field disables the automated funds capture.
   9. To use the WorldPay engine in the Test mode (no transactions will be actually sent) select the test transaction result from the Test mode drop-down menu. To use the plug-in in the live mode, select Off.
   10. Key in the Button title. For example, this could be the name of payment system. This title will be displayed directly on the button for online-payment at HSPstore, on the final stage of subscription registration, when a customer selects how to pay for the services ordered.
   11. You can add both the short and the detailed description. Quick description of a payment method will be displayed below the button. The Long description of a payment method will be displayed in a separate section entitled Pay Online.
2. Click the Update button.

Please send us your feedback on this help page