Company Blog Support
Frank Hagan
posted

Contents

    Back to Top

    Integrating with WorldPay

    Prerequisites

    About WorldPay

    WorldPay describes itself as "the UK and Europe's number one card payment processor" with up to 36 countries served. ONTRAPORT’s built-in integration is easy to set up, with just three entries into the Gateway configuration screen. 

    Countries Served

    Business Gateway account

    • UK and Ireland only

    Business Gateway Plus account

    • Andorra

    • Australia

    • Austria

    • Belgium

    • Cyprus

    • Czech Republic

    • Denmark

    • Finland

    • France

    • Germany

    • Gibraltar

    • Greece

    • Hong Kong

    • Hungary

    • Ireland

    • Israel

    • Italy

    • Liechtenstein

    • Luxembourg

    • Malta

    • Monaco

    • Netherlands

    • New Zealand

    • Norway

    • Poland

    • Portugal

    • San Marino

    • Singapore

    • Slovenia

    • Spain

    • Sweden

    • Switzerland

    • Turkey

    • United Kingdom

    • United States

    • Vatican City

     

    Obtain Worldpay Account Details

     

    1. Create an account at WorldPay

    2. Go to Installations

    3. Request that WorldPay setup the Invisible XML Installation for you

    4. Set your XML password

      1. Click the wrench icon under Integration Setup: PRODUCTION to set your XML Password

      2. Make sure "Store-builder used is set to Default and

      3. Make sure the Attach HTTP(s) Payment Message to the failure email? checkbox is checked.

        1. ONTRAPORT’s integration requires just the Installation ID,
          Merchant Code and XML Password (or, “Invisible auth password”)


     

    Check with WorldPay support for details on creating the Invisible XML Installation if it is not available in your account.

     

    Configure Worldpay Gateway

    1. Log into ONTRAPORT

    2. Click on Sales > Settings > Gateways


       
    3. Click the New Gateway button

       
    4. Select WorldPay from the Gateway Selection dropdown menu


       
    5. Fill in your WorldPay details

       
    6. Click Save

    Currency Options

    1. Visit Administration > Localization to select your currency setting in ONTRAPORT.

      administration data localization

      1. Select the currency from the drop down.

        Choose currency

      2. Choose how you want the currency symbol to appear. Typical choices include the currency symbol and currency abbreviation, or just the currency symbol, before or after the value. 

        choose currency format

      3. Select the number format in the last drop down box. Choices are to use the comma as the decimal separator, typical in Europe, or to use the period as the decimal separator.

        currency number format


    2. Verify that the gateway and currency setting work correctly. Process a live transaction on a valid credit card and verify the charge is reflected correctly in your payment gateway and bank. 

    3. Note that the new currency symbol is used on all items and sales reports in ONTRAPORT, including historical sales made prior to the change. It is up to you to segregate sales prior to the change and reflect them properly in your books. 

    Available Currencies with WorldPay

    • Australian Dollar (AUD)

    • Canadian Dollar (CAD)

    • Danish Krone (DKK)

    • Euro (EUR)

    • Hong Kong Dollar (HKD)

    • Norwegian Krone (NOK)

    • Japanese Yen (JPY)1
    • New Zealand Dollar (NZD)
    • Pound Sterling (GBP)

    • Singapore Dollar (SGD)

    • Swedish Krona (SEK)

    • Swiss Franc (CHF)

    • U.S. Dollar (USD)

    1 Note: ONTRAPORT's number format currently includes 2 decimal places, even when the Japanese Yen (JPY) is set as the currency. Because the Yen does not allow fractional amounts any value in the two decimal places is simply ignored (not rounded).

    Other Gateways Supporting Non-US Currency

    Other Resources

    ONTRAPORT Projects are in-app, step by step instructions to walk  you through the process step-by-step. You can pause and come back at any time, and using the training program does not interfere with using ONTRAPORT, making it ideal for both beginning and advanced ONTRAPORT clients. Have ONTRAPORT open in another tab and click the Project below:

    ONTRAPORT's Community Q&A Forum is our peer-to-peer support site for quick answers to your questions 24 hours a day! ONTRAPORT Support, our Certified Consultants, and your fellow entrepreneurs provide the answers.

    FAQs

    Q. Can I use a currency other than US Dollars?

    A. Yes, WorldPay accepts several different currencies including Australian Dollar (AUD), Canadian Dollar (CAD), Euro (EUR), Pounds Sterling (GBP) and Japanese Yen (JPY)1 in addition to the US Dollar (USD). Your ONTRAPORT account must be set to the same currency. Contact your WorldPay account representative for more information on setting WorldPay to use your currency. After you set WorldPay to bill in the currency of your choice you must change ONTRAPORT to the matching currency in Administration > Localization. This will also set the currency symbol for your reports, order forms, etc.

    Q. I changed my currency to Pounds Sterling (GBP) but all the sales values are the same in my account. They should be converted!

    A. ONTRAPORT does not do any currency conversion of existing sales values. You will need to download your transactions prior to the change and convert the values manually for your books. 

    Q. I switched my currency in ONTRAPORT and now all my orders are failing!

    A. The currency setting in ONTRAPORT must match the currency setting in the payment gateway. While some gateways refuse transactions with mismatched currency types, others will process the payment and you will incur extra currency exchange and processing fees.

    Q. I have $3,846 in currency exchange fees after switching my currency in ONTRAPORT! Are you going to reimburse me?

    A. The currency setting in ONTRAPORT must match the currency setting in the payment gateway. While some gateways refuse transactions with mismatched currency types, others will process the payment and you will incur extra currency exchange and processing fees from the gateway or the bank. ONTRAPORT will not reimburse you for these charges.

     

    Have more questions? Submit a request

    Comments

    Powered by Zendesk