Knowledgebase

Integrating the WorldPay Credit Card Gateway with our system is pretty simple. You do not have to write ANY Code. You simply have to fill in a form specifying your preferences and account details.

Before you Start

You will need to gather the following details about your WorldPay Merchant Account before you start:

• WorldPay Installation Id - Each WorldPay account user is assigned a unique Customer Account ID, along with one or more Installation IDs, for use in setting up and testing their integration with the WorldPay payment system. This Installation ID always needs to be included in each online transaction information sent to the WorldPay processing system. Installation IDs are unique numbers exclusive to your account and can not be changed.
   

• Secret Word - This should be a string (spaces are permitted) of up to 16 characters. This secret must be sent to the WorldPay Technical Support Team at support@worldpay.com, so they can add it to the MD5 secret for transactions in the configuration settings of your installation.
   

• Enable Callback - To redirect your Customers and Sub-Resellers back to their Control Panels after transacting through your WorldPay Payment Gateway, you would need to configure a few things in your WorldPay Merchant interface.
  
  1. Login into your Production/Live WorldPay interface from https://support.worldpay.com/admin/
  
  2. In the Installations for Your Company Name, search for your Installation ID and click on the Configuration options button.
  
  3. On the following page, mention the following details and click on the SAVE CHANGES button -

  a. Select the Callback enabled? and Use callback response? checkboxes
  
  b. Mention the Callback URL as http://<Your Branded Storefront URL>/reseller/paymentgateway/generic/PostFormGateway.jsp?PGNAME=worldpay
   

   

Adding the WorldPay Credit Card Gateway into your Reseller account

1. Login into your Reseller Control Panel from http://domains.bookandhost.com/reseller

2. Click on Settings -> Finance & Billing -> Payment Gateway -> List / Add

3. Click on the Add Payment Gateway button and then on the Add an WorldPay Credit Card Gateway link.

4. Enter the following details and save your changes by clicking on the Submit button.

Gateway Name - This Gateway Name would be shown to your Customers/Sub-Resellers, when they are about to make Payment. You can use something like "Credit Card Payment" or "Visa/Master Card", etc..

WorldPay Installation Id - Each WorldPay account user is assigned a unique Customer Account ID, along with one or more Installation IDs, for use in setting up and testing their integration with the WorldPay payment system. This Installation ID always needs to be included in each online transaction information sent to the WorldPay processing system. Installation IDs are unique numbers exclusive to your account and can not be changed.

Secret Word - This should be a string (spaces are permitted) of up to 16 characters. This secret must be sent to the WorldPay Technical Support Team at support@worldpay.com, so they can add it to the MD5 secret for transactions in the configuration settings of your installation.

Currency - Select the currency in which you want to charge your customers credit cards. Your Merchant Account needs to support the currency that is selected.

Currency Exchange Rate - If the Currency you selected in the previous option varies from your Selling Currency, we will have to convert the Invoice Value to the WorldPay Currency, BEFORE we send your Customer/Sub-Reseller's Details to WorldPay. For this purpose the system needs an exchange rate between the two.

You may choose to maintain this exchange rate yourselves or let us maintain it for you. We download forex rates on a daily basis from a recognized source and update exchange rates for you. If however you wish to update the rates yourselves then you may do so by selecting the "I would like to Maintain the currency exchange rate myself" checkbox AND entering your own conversion rates.

Select the types of CREDIT CARDS that your merchant account supports - You need to select the types of Credit Card that are supported by your Bank. The credit card types available are - Visa, Master, Amex. You can also decide the sequence in which you want your Customers / Sub-Resellers to view these Card types on the payment page.

Payment Gateway Access Level for Customers and Sub-Resellers - Click here to know more about Payment Gateway Transaction types and Access Levels for your Customers and Sub-Resellers >>

Deciding whether a Sub-Reseller and Customer is Credited with the Gross Amount or Net - Your WorldPay deducts a fee on a per transaction basis. There are two types of Transactions that can pass through your WorldPay integration - Invoice/Debit Note Payment, and Add Funds. Click here to know more about Payment Gateway Transaction types and Access Levels for your Customers and Sub-Resellers >>

In case of an Add Funds Transaction, you have the option of crediting your Customers/Sub-Resellers with the NET Amount that WorldPay credits you with, or choose to credit them with the gross funds and bear the charges yourselves. The NET Amount is calculated by subtracting the per transaction charges from the Transaction Amount. The per transaction charges are calculated by adding the Total Fixed fee charged per transaction and the Total Variable fee charged per transaction.

Total Fixed fee charged per transaction for your merchant account (Per Transaction Fixed Fee charged by your Bank + Per Transaction Fixed Fee charged by the WorldPay Credit Card Gateway) - Enter the total fixed fee that is charged per transaction in the given textbox. This information is primarily used to calculate the Net Amount that your merchant account is credited with, if you choose to credit your customer / sub-reseller with the Net Amount in an Add funds Transaction. Your bank and/or your gateway may be charging you a different amount of fixed fee per transaction for different credit card types e.g. a certain fixed fee per transaction for Visa cards and a different fixed fee for American Express cards. In case, the amount of fixed fee is different per credit card type, then enter the highest amount of fixed fees charged per transaction to your account e.g. if the total fixed fee for Visa Cards is 25 cents per transaction and the total fixed fee for American Express cards is 30 cents per transaction, then enter 0.30 in the textbox. If there is no fixed fee charged per transaction then enter 0.

Total Variable fee charged per transaction for your merchant account - Enter the total variable fee that is charged per transaction in the given textbox. This information is primarily used to calculate the Net Amount that your merchant account is credited with, if you choose to credit your customer / sub-reseller with the Net Amount in an Add funds Transaction. Your bank and/or your gateway may be charging you a different amount of variable fee per transaction for different credit card types e.g. a certain variable fee per transaction for Visa cards and a different variable fee for American Express cards. In case, the amount of variable fee is different per credit card type, then enter the highest amount of variable fees charged per transaction to your account e.g. if the total variable fee for Visa Cards is 2.50% per transaction and the total variable fee for American Express cards is 3.00% per transaction, then enter 3.00 in the textbox. If there is no variable fee charged per transaction then enter 0.
 

IMPORTANT

If you have selected to credit a Customer/Sub-Reseller with the Net Amount in an Add Funds transaction, then you must submit either a Fixed Transaction fee (greater than 0) or a Variable Transaction fee (greater than 0).

 

Send me a Reminder if a transaction is pending for more than x days - In case you have not yet accepted a payment sent to you via the WorldPay Payment Gateway, you can get e-mail reminders sent across to you from our system, after every x number of days, until you either Approve or Decline these payments. Click here to know how to Approve / Decline Payment Gateway transactions >>

Display Position - If you plan on adding Multiple Gateways you can select the position in which you wish to display this Gateway on your Payment Page.