### Configuring PayReady Payment Plug-in

The PayReady plug-in implemented in HSPcomplete allows using the PayReady Virtual Terminal provided by CardReady.

CardReady International Inc., established in September 1998, is a US based bankcard processing company providing authorizations for credit card, debit card, and Travel and Entertainment transactions and clearing and settlement services for these transactions.

To start accepting payments using the PayReady Virtual Terminal, first of all you need to to set up your CardReady Merchant Account. The test merchant ID can be obtained without the need to register or sign up. After you get a CardReady Merchant Account, all you need to do is change the PayReady ID to your own so that the transaction is sent to the live gateway. In addition, you will need to know the PayReady server hostname and paths used to form URLs to send transaction requests.

The plug-in supports the following transaction types:

- Preauth - the purchase amount is being reserved and the transaction suspended till authorization.
- Sale - a single-step transaction without pre-authorization;

After you set up your Merchant account and get all the necessary data, you can fill the PayReady plug-in configuration form in HSPcomplete, activate the plug-in and start using the PayReady services.

To configure the PayReady plug-in:

1. Click the Edit button on the plug-in screen. Fill the form that appears:
   1. Enter the PayReady server hostname into the Server field.
   2. Type the number of the port where the PayReady server listens for transaction requests into the Server Port field.
   3. Into the Path to CGI-script for auth transactions field, enter the path to be appended to the PayReady server hostname to form the URL to send the preauth transaction requests.
   4. Into the Path to CGI-script for capture transactions field, enter the path to be appended to the PayReady server hostname to form the URL to send the capture transaction requests.
   5. Type your PayReady Merchant ID into the Merchant ID 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. Select the type of transactions to process: if you want to process only the transactions of the Preauth type, then check the Preauthorization enabled box, if you want to process the Sale transactions only, then leave this box clear.
   8. You can enable the AVS checking for credit cards used. The AVS designation is described earlier in this guide. To set the AVS to be passed as a strict requirement of transactions processing, check the Reject transaction if AVS is unavailable box.
   9. For the AVS checking, you can explicitly set the types of mismatches detected, when transactions must be rejected. Please, select one of the variants from the Reject transaction according to AVS check result drop-down menu. In this case, Never means that transactions will be approved without respect to possible AVS mismatches. Any of the other mismatch types, if detected, will result in the automated transaction voiding on the payment gateway side.
   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