X-Cart:EWay - Hosted payment

From X-Cart 4 Classic
Revision as of 11:26, 22 May 2012 by Seyfin (talk | contribs) (How do I update the older "eWAY - Shared payment" payment module to support the newer API?)
Jump to: navigation, search
In 4.4.3 and earlier versions the payment module's name was "eWay UK (Hosted payment page)".
The "eWay - Hosted payment" payment module implements the API which is also currently known as "Shared Payments".

eWAY is the leading Internet payment gateway provider operating in Australia, New Zealand, United Kingdom and Europe. eWAY connects your website directly to your bank to process your customers online credit card payments instantly. Allowing your business to securely trade 24/7 all over the globe, truly automating the website payment component of your business.

Obtaining an eWay Account

If you have not registered an account with eWay yet, you should do it before you start setting up eWay in X-Cart. To open an account, go to the eWay website at https://eway.secure.force.com/join/SignUpInfoUK and follow the instructions on the screen. After you have registered an account, you can set up eWay in the X-Cart Admin area.

Setting up "eWay - Hosted payment" payment method

To use "eWay - Hosted payment" as one of the payment options in the store:

  1. Log in to the X-Cart Admin area.
  2. Go to the Payment methods section (Administration menu -> Payment methods) and scroll down to the Payment gateways form.
  3. Select eWay from the drop-down list and click the Add button.

    Pg eWay 01.gif

    After you have clicked on Add, eWay will be added to the list of the available payment methods.

    Pg eWay 02.gif
    Note: If you set up a payment method providing online credit card payment processing and do not intend to process credit card payments manually, you should disable the default "Credit Card" payment method, that requires manual payment processing, by unselecting the check-box next to the payment method's name. Additionally, you can change the default "Credit Card" payment method's name to "Credit Card (offline)", and change the online payment method's name to "Credit Card". This will help you to avoid any confusion between these two payment methods.
    The $store_cc variable in the config.php file must be set to false in case you disable the default 'Credit Card' payment method and do not intend to process credit card payments manually.
  4. Click on the Configure link. This opens the configuration page for eWay.

    Pg eWay 03.gif

  5. Adjust the configuration settings for eWay and click the Update button to apply the changes.
    • Return URL: The URL to which eWay must land customers back to X-Cart after a payment has been processed.
    • Instance ID: Enter the name of your merchant account with eWay.
    • Currency: Choose the currency in which you wish to accept payments through eWay.
    • Test/Live mode: Choose the mode in which the gateways must operate.

      The "test:approved" mode means that you can submit test orders and perform test transaction, and all the transactions will always be approved by the eWay test environment. The "test:declined" mode means that you can submit test orders and perform test transaction, and all the transactions will always be declined by the eWay test environment. In both modes money will not be withdrawn from credit cards.

      The "live" mode is the full functioning mode with real transactions and charges. It must be used when only you are ready to go live.

    • Automatically redirect back to the store: Choose Yes if your customers should be forced to return to your store automatically, or choose No if customers should be able to return to the store manually by clicking a special button on the side of eWay.
    • Order prefix: Enter a prefix that will be automatically added to IDs of orders placed in your store and paid through eWay.

      Having a prefix ensures that orders will have unique IDs and will never coincide with orders placed in another online store of yours that also uses eWay as a payment option.
  6. Return to the list of payment methods and activate eWay by selecting the check box next to the gateway's name.
  7. Click the Update button.
  8. Adjust the configuration setting in the eWay back-office.

Troubleshooting

How do I update the older "eWAY - Shared payment" payment module to support the newer API?

The below applies to 4.4.3 and earlier versions.

1) Мodify the '<xcart_dir>/payment/cc_eway_uk.php' file:

- find this line:

$url = 'https://www.ewaygateway.com:443/Gateway/UK/Results.aspx?'; . func_http_build_query($post);

- and change it to:

$url = 'https://au.ewaygateway.com:443/Result/?'; . func_http_build_query($post); // for Australian merchants

- OR change it to:

$url = 'https://nz.ewaygateway.com:443/Result/?'; . func_http_build_query($post); // for New Zealand merchants

- also, find this line:

$url = 'https://payment.ewaygateway.com:443/Request/?'; . func_http_build_query($post);

- and change it to:

$url = 'https://au.ewaygateway.com:443/Request/?'; . func_http_build_query($post); // for Australian merchants

- OR change it to:

$url = 'https://nz.ewaygateway.com:443/Request/?'; . func_http_build_query($post); // for New Zealand merchants

2) Update the payment method name in the database - execute the following SQL-query:

UPDATE xcart_ccprocessors SET module_name = 'eWay - Hosted payment' WHERE module_name = 'eWay UK (Hosted payment page)';

Use phpMyAdmin utility supplied by your hosting company, or "Patch/Upgrade" utility in X-Cart admin back-end to do it.

3) Go to your X-Cart admin back-end, "Payment methods" page, disable the older "eWAY - Shared payment" payment method.

4) Add, configure and enable the newer "eWay - Hosted payment" payment method.