Difference between revisions of "X-Cart:Protx/Sage Pay API update"

From X-Cart 4 Classic
Jump to: navigation, search
Line 3: Line 3:
 
A Sage Pay rep said:
 
A Sage Pay rep said:
  
: ''On the integration side of things there is a requirement to change the URL end points from Protx.com to Sagepay.com: http://protx.gtml1.com/Protxlz/Instances/Protxlz/documents/URLs.pdf ''
+
<div>: ''On the integration side of things there is a requirement to change the URL end points from Protx.com to Sagepay.com: [http://help.qtmsoft.com/images/b/b0/URLs.pdf URL end points changes]''<ins>.</ins></div>
 
: ''But it is not an urgent change as both old and new URL end points will be active for the next 6 months.''
 
: ''But it is not an urgent change as both old and new URL end points will be active for the next 6 months.''
 +
 +
{{Note1|<ins>Here are the specific </ins>URL end points changes <ins>that </ins>should be applied to your X-Cart installation:
 +
* payment/cc_protxdir.php (VSP Direct)
 +
: the following URLs:
 +
:: https://ukvpstest.protx.com:443/VSPSimulator/VSPDirectGateway.asp
 +
:: https://ukvpstest.protx.com:443/vspgateway/service/vspdirect-register.vsp
 +
:: https://ukvps.protx.com:443/vspgateway/service/vspdirect-register.vsp
 +
:: https://ukvpstest.protx.com:443/VSPSimulator/VSPDirectCallback.asp
 +
:: https://ukvpstest.protx.com:443/vspgateway/service/direct3dcallback.vsp
 +
:: https://ukvps.protx.com:443/vspgateway/service/direct3dcallback.vsp
 +
: should be replaced with these URLs correspondingly:
 +
:: https://test.sagepay.com:443/Simulator/VSPDirectGateway.asp
 +
:: https://test.sagepay.com:443/gateway/service/vspdirect-register.vsp
 +
:: https://live.sagepay.com:443/gateway/service/vspdirect-register.vsp
 +
:: https://test.sagepay.com:443/Simulator/VSPDirectCallback.asp
 +
:: https://test.sagepay.com:443/gateway/service/direct3dcallback.vsp
 +
:: https://live.sagepay.com:443/gateway/service/direct3dcallback.vsp
 +
* payment/cc_protx.php (VSP Form)
 +
: the following URLs:
 +
:: https://ukvpstest.protx.com/VSPSimulator/VSPFormGateway.asp
 +
:: https://ukvpstest.protx.com/vspgateway/service/vspform-register.vsp
 +
:: https://ukvps.protx.com/vspgateway/service/vspform-register.vsp
 +
: should be replaced with these URLs correspondingly:
 +
:: https://test.sagepay.com/Simulator/VSPFormGateway.asp
 +
:: https://test.sagepay.com/gateway/service/vspform-register.vsp
 +
:: https://live.sagepay.com/gateway/service/vspform-register.vsp
 +
}}
  
 
But it is not the only change. Protx/Sagepay updated their validation rules:
 
But it is not the only change. Protx/Sagepay updated their validation rules:
Line 34: Line 61:
 
* upload the attached [http://help.qtmsoft.com/index.php?title=File:Func.cc_protx_common.php func.cc_protx_common.php] file to the <u>include/func</u> directory of your store. Make sure that the file name does not start with a capital letter, otherwise Protx payment method will not work after the patch has been applied.
 
* upload the attached [http://help.qtmsoft.com/index.php?title=File:Func.cc_protx_common.php func.cc_protx_common.php] file to the <u>include/func</u> directory of your store. Make sure that the file name does not start with a capital letter, otherwise Protx payment method will not work after the patch has been applied.
 
* if you use Protx Direct, apply the [http://help.qtmsoft.com/index.php?title=File:Protx_direct_41x.diff protx_direct_41x.diff] patch. If you use Protx Form, apply the [http://help.qtmsoft.com/index.php?title=File:Protx_form_41x.diff protx_form_41x.diff] patch
 
* if you use Protx Direct, apply the [http://help.qtmsoft.com/index.php?title=File:Protx_direct_41x.diff protx_direct_41x.diff] patch. If you use Protx Form, apply the [http://help.qtmsoft.com/index.php?title=File:Protx_form_41x.diff protx_form_41x.diff] patch
 
  
 
'''Note''': If you experience any difficulties downloading func.cc_protx_common.php file, please download [http://help.qtmsoft.com/index.php?title=File:Func.cc_protx_common.php.txt this file], rename it to func.cc_protx_common.php and upload to the include/func directory of your store.
 
'''Note''': If you experience any difficulties downloading func.cc_protx_common.php file, please download [http://help.qtmsoft.com/index.php?title=File:Func.cc_protx_common.php.txt this file], rename it to func.cc_protx_common.php and upload to the include/func directory of your store.
 
  
 
'''If you use v4.0.x or older''', please contact our support team.
 
'''If you use v4.0.x or older''', please contact our support team.

Revision as of 13:20, 9 September 2010

Protx changed its name to Sage Pay this spring. However, this change affects not just the name and the logo. There are slight changes in the products as well.

A Sage Pay rep said:

: On the integration side of things there is a requirement to change the URL end points from Protx.com to Sagepay.com: URL end points changes.
But it is not an urgent change as both old and new URL end points will be active for the next 6 months.

But it is not the only change. Protx/Sagepay updated their validation rules:

In order to continue to deliver high levels of security we recently performed an in-depth scan of vendors who are passing invalid characters to the Sage Pay systems. We noticed that you are one of these vendors and strongly advise you to update your integration as soon as possible. Accepting invalid characters is not considered best practice and we are therefore updating our systems accordingly.

How this affects you:

We are implementing an update to the Sage Pay integration protocol on Friday the 29th of May 2009.

This update increases the stringency of the character validation checks performed on incoming transactions to our systems, and is designed to ensure that transactions which include invalid characters are rejected.

This means that as of the 29th of May 2009 any transactions passed to Sage Pay that include invalid characters will be rejected. Your business will therefore be unable to process transactions after this date if no action is taken.

The SagePay/Protx integration was updated in X-Cart v.4.2.2 and higher. So if you use this or newer version of X-Cart, you don't need to modify anything.

If you use the older version of X-Cart, you need to update your store and apply the attached patches.

For v4.2.1 and v4.2.0:

  • upload the attached func.cc_protx_common.php file to the include/func directory of your store. Make sure that the file name does not start with a capital letter, otherwise Protx payment method will not work after the patch has been applied.
  • if you use Protx Direct, apply the protx_direct_42x.diff patch. If you use Protx Form, apply the protx_form_42x.diff patch

For 4.1.x:

  • upload the attached func.cc_protx_common.php file to the include/func directory of your store. Make sure that the file name does not start with a capital letter, otherwise Protx payment method will not work after the patch has been applied.
  • if you use Protx Direct, apply the protx_direct_41x.diff patch. If you use Protx Form, apply the protx_form_41x.diff patch

Note: If you experience any difficulties downloading func.cc_protx_common.php file, please download this file, rename it to func.cc_protx_common.php and upload to the include/func directory of your store.

If you use v4.0.x or older, please contact our support team.