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

From X-Cart 4 Classic
Jump to: navigation, search
m
Line 1: Line 1:
 
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.
 
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:
+
A SagePay 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://help.qtmsoft.com/images/b/b0/URLs.pdf Source and destination URLs]''
 
: ''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 Source and destination URLs]''
Line 34: Line 34:
 
}}
 
}}
  
But it is not the only change. Protx/Sagepay updated their validation rules:
+
Updating the Protx URLs to Sagepay URLs is the main, but not the only change. Protx/Sagepay also updated their integration protocol from version 2.22 to 2.23. Here is a quotation from the email received from SagePay:
  
 
: ''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.''
 
: ''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:'''
+
: ''How this affects you:''
  
 
: ''We are implementing an update to the Sage Pay integration protocol on Friday the 29th of May 2009.''
 
: ''We are implementing an update to the Sage Pay integration protocol on Friday the 29th of May 2009.''
Line 46: Line 46:
 
: ''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.''
 
: ''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.
+
The SagePay/Protx integration was updated in X-Cart v.4.2.2 and higher to use the new protocol version 2.23. If you use an older version of X-Cart, we recommend you to update the SagePay/Protx integration in your X-Cart store. To do it, you should apply the corresponding patch.
  
If you use the older version of X-Cart, you need to update your store and apply the attached patches.
+
'''For v.4.1.12, v.4.2.0 and v.4.2.1:'''
  
'''For v4.2.1 and v4.2.0:'''
+
You can find the patch by the following path in the "File area" section of your Qualiteam account:
  
* 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.
+
: X-Cart -> X-Cart supporting files for prev versions -> X-Cart 4.1 -> X-Cart 4.1.12 -> Updates and patches -> protx-sage_pay-patch-2010-05-28_4.1.12.tgz
* if you use Protx Direct, apply the [http://help.qtmsoft.com/index.php?title=File:Protx_direct_42x.diff protx_direct_42x.diff] patch. If you use Protx Form, apply the [http://help.qtmsoft.com/index.php?title=File:Protx_form_42x.diff protx_form_42x.diff] patch
+
: X-Cart -> X-Cart supporting files for prev versions -> X-Cart 4.2 -> X-Cart 4.2.0 -> Updates and patches -> protx-sage_pay-patch-2010-05-28_4.2.0.tgz
 +
: X-Cart -> X-Cart supporting files for prev versions -> X-Cart 4.2 -> X-Cart 4.2.1-> Updates and patches -> protx-sage_pay-patch-2010-05-28_4.2.1.tgz
  
'''For 4.1.x:'''
+
NOTE: In X-Cart v.4.2.2, v.4.2.3 and v.4.3.0 some problems related to Sage Pay (Protx) payment gateway were fixed. Thus, we also created patches for these versions, which include the corresponding bug-fixes only. The patches can be found in the "File area" section as well.
  
* 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 older versions''', please contact our support team.
* 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.
 
 
 
'''If you use v4.0.x or older''', please contact our support team.
 
  
 
[[Category:API updates]]
 
[[Category:API updates]]
 
[[Category:X-Cart user manual]]
 
[[Category:X-Cart user manual]]

Revision as of 09:59, 7 October 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 SagePay rep said:

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

Updating the Protx URLs to Sagepay URLs is the main, but not the only change. Protx/Sagepay also updated their integration protocol from version 2.22 to 2.23. Here is a quotation from the email received from SagePay:

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 to use the new protocol version 2.23. If you use an older version of X-Cart, we recommend you to update the SagePay/Protx integration in your X-Cart store. To do it, you should apply the corresponding patch.

For v.4.1.12, v.4.2.0 and v.4.2.1:

You can find the patch by the following path in the "File area" section of your Qualiteam account:

X-Cart -> X-Cart supporting files for prev versions -> X-Cart 4.1 -> X-Cart 4.1.12 -> Updates and patches -> protx-sage_pay-patch-2010-05-28_4.1.12.tgz
X-Cart -> X-Cart supporting files for prev versions -> X-Cart 4.2 -> X-Cart 4.2.0 -> Updates and patches -> protx-sage_pay-patch-2010-05-28_4.2.0.tgz
X-Cart -> X-Cart supporting files for prev versions -> X-Cart 4.2 -> X-Cart 4.2.1-> Updates and patches -> protx-sage_pay-patch-2010-05-28_4.2.1.tgz

NOTE: In X-Cart v.4.2.2, v.4.2.3 and v.4.3.0 some problems related to Sage Pay (Protx) payment gateway were fixed. Thus, we also created patches for these versions, which include the corresponding bug-fixes only. The patches can be found in the "File area" section as well.

If you use older versions, please contact our support team.