Difference between revisions of "X-Cart:EWay - Hosted payment"

From X-Cart 4 Classic
Jump to: navigation, search
(Intro updated)
(Setting up "eWay - Hosted payment" payment method: https://go.eway.io/s/article/Where-can-I-find-my-eWAY-Customer-ID)
 
(11 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 +
{{Note1| In 4.4.3 and earlier versions the payment module's name was "eWay UK (Hosted payment page)".}}
 +
 +
{{Note1| The "eWay - Hosted payment" payment module implements the API which is also currently known as [http://www.eway.com.au/developers/api/shared-payments.html "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.
 
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==
 
==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://secure.eWay.com/app/application.pl and follow the instructions on the screen. After you have registered an account, you can set up eWay in the X-Cart Admin area.
+
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==
+
==Setting up "eWay - Hosted payment" payment method==
  
To use eWay as one of the payment options in the store:
+
'''To use "eWay - Hosted payment" as one of the payment options in the store:'''
  
 
# Log in to the X-Cart Admin area.
 
# Log in to the X-Cart Admin area.
 
# Go to the <u>Payment methods</u> section (Administration menu -> Payment methods) and scroll down to the <u>Payment gateways</u> form.
 
# Go to the <u>Payment methods</u> section (Administration menu -> Payment methods) and scroll down to the <u>Payment gateways</u> form.
# Select eWay from the drop-down list and click the '''Add''' button.<br><br>[[Image:pg_eWay_01.gif|640px]]<br><br>After you have clicked on Add, eWay will be added to the list of the available payment methods.<br><br>[[Image:pg_eWay_02.gif|640px]]<br>{{Note1|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.}}{{Note1|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.}}
+
# Select eWay from the drop-down list and click the '''Add''' button.<br><br>[[Image:pg_eWay_01.gif]]<br><br>After you have clicked on Add, eWay will be added to the list of the available payment methods.<br><br>[[Image:pg_eWay_02.gif]]<br>{{Note1|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.}}{{Note1|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.}}
# Click on the Configure link. This opens the configuration page for eWay.<br><br>[[Image:pg_eWay_03.gif|640px]]<br><br>
+
# Click on the Configure link. This opens the configuration page for eWay.<br><br>[[Image:pg_eWay_03.gif]]<br><br>
 
# Adjust the configuration settings for eWay and click the Update button to apply the changes.
 
# Adjust the configuration settings for eWay and click the Update button to apply the changes.
 +
#* <u>eWAY Customer ID: </u>https://go.eway.io/s/article/Where-can-I-find-my-eWAY-Customer-ID.
 
#* <u>Return URL: </u>The URL to which eWay must land customers back to X-Cart after a payment has been processed.
 
#* <u>Return URL: </u>The URL to which eWay must land customers back to X-Cart after a payment has been processed.
 
#* <u>Instance ID</u>: Enter the name of your merchant account with eWay.
 
#* <u>Instance ID</u>: Enter the name of your merchant account with eWay.
Line 26: Line 31:
 
#* Click on Configuration options link opposite your Installation ID.
 
#* Click on Configuration options link opposite your Installation ID.
 
#* Select the following check boxes: Callback enabled? and Use callback response?.
 
#* Select the following check boxes: Callback enabled? and Use callback response?.
#* Set the Callback URL http://www.example.com/xcart/payment/cc_eWay.php replacing the http://www.example.com/xcart/ part with the true URL of your X-Cart store.<br><br>After you have configured and activated the gateway, your customers will be able to choose eWay as a payment option.<br><br>[[Image:pg_eWay_04.gif|640px]]
+
#* Set the Callback URL http://www.example.com/xcart/payment/cc_eWay.php replacing the http://www.example.com/xcart/ part with the true URL of your X-Cart store.<br><br>After you have configured and activated the gateway, your customers will be able to choose eWay as a payment option.<br><br>[[Image:pg_eWay_04.gif]]
  
 
==Troubleshooting==
 
==Troubleshooting==
 
===How do I update the older "eWAY - Shared payment" payment module to support the newer API?===
 
===How do I update the older "eWAY - Shared payment" payment module to support the newer API?===
 +
 +
{{Note1|The below applies to 4.4.3 and earlier versions.}}
  
 
1) Мodify the '<xcart_dir>/payment/cc_eway_uk.php' file:
 
1) Мodify the '<xcart_dir>/payment/cc_eway_uk.php' file:
Line 69: Line 76:
 
[[Category:X-Cart modules]]
 
[[Category:X-Cart modules]]
 
[[Category:Payment gateways]]
 
[[Category:Payment gateways]]
 +
 
[[Category:X-Cart modules]]
 
[[Category:X-Cart modules]]
 
[[Category:Payment gateways]]
 
[[Category:Payment gateways]]
[[Category:X-Cart modules]]
+
 
[[Category:Payment gateways]]
+
==eWay integration in X-Cart 4.7.6==
[[Category:X-Cart modules]]
+
 
[[Category:Payment gateways]]
+
Starting with 4.7.6 version eWay – Responsive Shared Page method is available in the admin area of your store. The Responsive Shared Page comes with built in integration with 3D Secure, PayPal, MasterPass and Visa Checkout. More information can be found here https://www.eway.com.au/developers/api/responsive-shared-page
 +
 
 +
Pay attention that the existing integration ‘eWay – Hosted payment’ has been renamed to ‘eWay – Hosted payment (old integration)’. An obsolete ‘eWAY – Stored payment (Shared)’ integration has been removed.
 +
 
 +
[[File:eWay.png|border|1000px]]

Latest revision as of 16:38, 19 July 2018

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.
    • eWAY Customer ID: https://go.eway.io/s/article/Where-can-I-find-my-eWAY-Customer-ID.
    • 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.

eWay integration in X-Cart 4.7.6

Starting with 4.7.6 version eWay – Responsive Shared Page method is available in the admin area of your store. The Responsive Shared Page comes with built in integration with 3D Secure, PayPal, MasterPass and Visa Checkout. More information can be found here https://www.eway.com.au/developers/api/responsive-shared-page

Pay attention that the existing integration ‘eWay – Hosted payment’ has been renamed to ‘eWay – Hosted payment (old integration)’. An obsolete ‘eWAY – Stored payment (Shared)’ integration has been removed.

EWay.png